Getting Started
Getting Started
Clone Valcraven, run it locally, and understand how the project is laid out.
Valcraven is a production-ready Next.js SaaS template that runs on Cloudflare's developer platform (Workers via OpenNext, D1, R2, Queues, plus a separate realtime Worker). You copy it and own the result — it is a starter you build on, not a framework you depend on.
This section gets you from a fresh clone to a running app and oriented in the codebase. Start with the Quickstart, then dip into the other pages as you need them.
- Quickstart — Prerequisites, running the dev stack with Docker Compose, and the URL your app comes up on.
- Create a project — Scaffold a brand-new, fully-branded app from the template with the
/valcraven-createskill (or the Go CLI). - OAuth setup — Wire up Google, GitHub, and Apple sign-in via Better Auth, and automate it with the
/configure-ssoskill. - Environment variables — The handful of variables you need to run locally, and where to set them. (Full reference: /docs/reference/environment-variables.)
- Project structure — The monorepo layout at a glance:
apps/web,apps/realtime,apps/mobile, andpackages/core.
Once you're running, head to Building with Valcraven to add your first feature, or Features to see everything that's already included.