Team Cartographer's LMCC (Local Mission Control Console) code for the NASA SUITS (Spacesuit User Interface Technologies for Students) Challenge 2023/24.
This project is bundled with NextJS and styled with TailwindCSS, ShadCN UI and Material UI, with Flask for a custom Python Backend API.
Contents:
Software Dependencies
NodeJS 21.5.0+npm 10.2.4Python 3.12.1git 2.43.0
Questions? Send an email to teamcartographer@gmail.com and we will get back to you as soon as possible.
Thank you for reading!
- Docs can be found at: https://tclmcc.gitbook.io/docs/
- You can try the LMCC App by running the development environments found in the Usage section below.
- This app runs concurrently with the SUITS 2024 TSS Server. Please set this up to run the app, or make sure you have another computer available with a server to use that (learn more here)
- more coming soon!
First, clone the repository:
git clone https://github.com/Team-Cartographer/SUITS-2024-LMCC.git
# and
cd SUITS-2024-LMCCcd into the newly cloned repository before running any further steps
When you run the application, your console of choice (regardless of platform) will ask you this question:
do you want to run the app (frontend, server, TSS) on your machine? (Y/n):
If you answer with Y, the application will be launched on your computer. This requires the TSS Server found in About the App to be running concurrently.
If you answer with N, your setup is complete. You can simply open the external URLs provided by another user which will be printed to their shell once they run either start.sh or ./Setup.ps1. After that, your app will be running on their servers, mantaining a consistent environment across all testing platforms.
For most testing cases, please answer Y, unless you have another computer on the same network with the LMCC server ready to use.
Keep in mind that the LMCC window must be full screen. Portions of our app may not work properly with a collapsed window!
Since the App is built for Mac, Linux, and Windows, you can follow your platform specific instructions below:
To set up the entire application and run it on MacOS, you do not need to follow any of the steps below. Simply do the commands below in the terminal.
chmod +x start.sh
# and
./start.sh
# type Ctrl+C to end the programThis will install all dependencies for NodeJS and Python, and start both the LMCC Frontend and Backend Servers on network-public URLs. You can use these for testing or for development.
If you would like to open the 3 pages (SUITS TSS Server, LMCC Frontend, LMCC Backend), do the script with the --open argument:
./start.sh --open
This will automatically open the 3 pages in your default browser after 1-2 seconds, allowing time for the servers to begin.
End the LMCC App by doing Ctrl+C in your Terminal. Don't forget to end the SUITS TSS Server as well!
This app strictly runs in Windows Powershell. Please make sure you have that up-to-date before following the rest of these instructions
For Windows Setup, there is a couple extra steps as Windows scripting isn't as easy as MacOS. However, we have tried to simplify it as much as possible.
If you answered with n to the question from Local and External Servers, then these next steps are not required as you are loading an external URL.
If you are running locally, follow these commands:
# this will run app setup
# you can re-run this any time you update dependencies
./Setup.ps1
# answer with *Y* to the local app promptOnce you finish setup, do these commands in seperate terminal windows:
cd client
# and
npm run dev
# type Ctrl+C to end frontend user interfacecd server
# and
. .\venv\Scripts\Activate.ps1
# and
python server.py
# type Ctrl+C to end backend server
deactivate # to end venvLet us know with any issues or questions!
Contact @abhi-arya1 with any questions!