🚀 Getting started
This guide walks you through the minimal steps required to run the Rune Rising development environment locally. It covers environment file setup, installing dependencies, and starting the services used during development.
Prerequisites
Setup Environment
Before installing dependencies or starting the services, copy the example environment files into place for both the /server and /app packages. From the repository root run:
cp server/.env.example server/.env
cp app/.env.example app/.env
The default values should be fine, adjust the .env files if you need to change any settings.
Run the Development Environment
Install dependencies from the project root:
pnpm install
Start the development environment (runs /server, /app, and the database):
pnpm run dev
For first-time setup, or after making database schema changes, run the DB reset script (with the database running) to apply migrations and seed data:
pnpm --prefix server db:reset
You find see more db:* commands in the /server/package.json scripts section.
That's it — the services will be launched for you. If you prefer to run services individually, you can start the app and server packages separately, but the root pnpm run dev is the recommended developer workflow.
Running Tests
Run all unit tests across the workspace (based on vitest):
pnpm test
Run the integration tests for the app package:
pnpm run test:integration
Run tests for a single package (example: app):
pnpm --filter app test