Development setup

You need Node.js at the version in .nvmrc, pnpm 10 or later, Docker and Git.

Devcontainer

Open the repository in the devcontainer. It installs the dependencies and starts PostgreSQL, Redis and Obscura.

cp .env.example .env.local
pnpm run dev

Tip

To customise the devcontainer, copy .devcontainer/default to a new folder next to it. Git only tracks default.

Locally

git clone https://github.com/norish-recipes/norish.git
cd norish

# Also installs the recipe parser's Python environment
pnpm install

cp .env.example .env.local

# Starts PostgreSQL, Redis and Obscura
pnpm run docker:up

pnpm run dev

.env.local needs at least DATABASE_URL, REDIS_URL, AUTH_URL and MASTER_KEY, see Server & runtime. .env.example already points OBSCURA_ENDPOINT at the local stack.

Contributing

The commands, code style and pull request process can be found on GitHub in CONTRIBUTING.md.