Quick start

This guide assumes a local development stack. For production URLs, use the values your administrator provides.

Prerequisites

• Ragnarock web app running (default http://localhost:3000)
• Backend API running (default http://localhost:8000)
• Docker services: Postgres, Redis, Typesense (see Local setup)

1. Configure the frontend

Create ragnarock/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:8000

The API client sends session cookies to this host. Better Auth lives at http://localhost:8000/api/auth (not under /api for all REST routes).

2. Sign in

1. Open http://localhost:3000.
2. Go to Sign up (/sign-up) or Sign in (/sign-in).
3. Complete email verification if your deployment requires it.
4. If prompted, select or create an organization.

Details: Create account.

3. Create or open a project

1. Navigate to Projects — /dashboard/projects.
2. Create a project or open one you were invited to.
3. Open Members and confirm your persona matches how you will use AI (developer vs business owner, etc.).

4. Run through the core workflow

5. Invite your team

1. Members → invite by email.
2. Assign personas per role.
3. Share this documentation site for shared vocabulary.

API quick reference

Full reference: Backend and Scalar at http://localhost:8000/docs.