These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
The following software is required to be installed on your system:
We recommend using mise to install and manage all the programming
languages' requirements. The required versions are listed in the
.tool-versions file, which mise reads.
First, clone the repository:
git clone git@github.com:cesium/hydrogen.git
cd hydrogen
git checkout develop
Then, if you are using mise, install the required tools:
mise install
Next, install the dependencies:
bun i
Finally, create your environment file and change it as needed:
cp .env.local.sample .env.local
| Variable | Description |
|---|---|
SHOPKIT_API_KEY |
API key used to fetch the store's products |
UMAMI_URL |
URL of the Umami analytics instance |
UMAMI_WEBSITE_ID |
Website ID in Umami |
NEXT_PUBLIC_CURRENT_MANDATE |
Current team mandate (e.g. 2026-2027) |
NEXT_PUBLIC_ATLAS_API_URL |
URL of the Atlas API, used to fetch the events |
Start the development server and then you can open http://localhost:3000.
bun dev
Lint your code.
bun lint
Format your code.
bun format
You can use these resources to learn more about the technologies this project uses.