Constellation is an environment for JavaScript (Or TypeScript) based apps to run inside.
If you want to run the latest version of Constellation, it is pre-built at https://constellation-sys.vercel.app
If you want to run either an old version or the development branch, follow these instructions:
Constellation has two version histories in this repository, Constellation[Castorea] and the current version.
Generally, the split is defined as the commit on the 15th of June 2025
(291332b), Restart the Project
If you are trying to run a version from before here - note you need another repository. Running this version is not supported at this time, and you're on your own.
To get the source code, simply use git - but it is important to pass
--recursive to clone the submodules.
git clone https://github.com/ThatBeaverDev/Constellation --recursiveIf you are trying to run the development branch:
git checkout devOtherwise, I trust you know how to use checkout to get to another commit - it is recommended to look for groups and go for the last one, since they may be out of order.
Once cloned and within the directory (cd Constellation), you can get it built.
Constellation has 3 commands to help with building it.
npm run newenv- This runs the other two commands together along with others like
npm install, useful for a first clone
- This runs the other two commands together along with others like
npm run build- This builds the project, allowing it to be ran.
npm run dev- This runs a local webserver so you can access the project from the web.
I'm going to assume you want to setup a new environment:
npm run newenvThis will set everything up
Once this is finished, Constellation should be accessible from
http://localhost:5173.
Since Constellation uses TypeScript for large parts of the code, it must be compiled. Constellation can be compiled with this command:
npm run buildHowever, this recompiled everything. To just recompile Apps, you can just run this command, which should compile faster:
npm run build-apps