Back to builds

    How to download and run a build

    Every Lumina build is a public repository under the MIT licence. You can clone it, run it, change it, and use it in your own work. The steps are the same for all of them, and none of it costs anything.

    1. Install Node

    You need Node 18 or newer. Installing Node also installs npm, which is what runs the commands below. If you are not sure whether you already have it, run node --version in a terminal.

    Download Node

    2. Clone and install

    Replace the repository URL with whichever build you want. Each build page has its own link.

    Terminal
    git clone <repository-url>
    cd <project-folder>
    npm install

    3. Environment variables

    Some builds talk to a backend and some do not. If the project has a .env.example file, copy it and fill in your own values. The repositories never contain working keys, so you are always supplying your own.

    Terminal
    cp .env.example .env

    If there is no .env.example, the project runs entirely in the browser and there is nothing to configure.

    4. Run it

    Terminal
    npm run dev

    The terminal prints a local address, usually http://localhost:5173. Open it in a browser. To build a production copy instead, run npm run build.

    If something breaks

    • A missing package after install usually means dev dependencies were skipped. Run npm install --include=dev.
    • A port already in use means something else is running there. Stop it, or let the dev server pick the next port when it offers.
    • Anything else is worth an issue on the repository. They are public and I read them.

    The repositories

    Ask Lumina

    Services, scoping, or call prep.

    Type your question below, or choose a starting point: