⬡ vikitGet kits →

Quick Start

Ship a production feature in about 15 minutes — no boilerplate, no setup hell. This walk-through adds email and OAuth authentication to a Next.js app end to end.

Prerequisites

  • vikit-cli installed (vk --version works)
  • Claude Code running and authenticated
  • A project initialized with Vikit (vk init)

Step 1 — Bootstrap your project

Scaffold a new project with the engineer package, then drop into it:

  • .claude/ — agents, commands, and skills
  • docs/ — auto-generated project docs
  • plans/ — implementation-plan storage
vk init my-app --kit engineer cd my-app

Step 2 — Plan the feature

Describe the feature in one line. The planner agent spawns researcher agents in parallel, analyzes your codebase, and writes a detailed plan:

  • Researches current best practices (e.g. Next.js + Better Auth)
  • Analyzes your codebase structure
  • Writes the plan under plans/ and lists files to create and modify
/vk:eng:plan add user authentication with email/password and OAuth

Step 3 — Implement

Skim the plan, then ask Claude Code to implement it. Vikit installs dependencies, generates UI and API routes, adds middleware, writes tests, and updates the docs:

  • Installs packages and writes configuration
  • Generates login, signup, and reset pages plus API routes
  • Adds middleware to protect routes
  • Writes tests and updates docs/
# Tell Claude Code: Implement the auth plan

Step 4 — Run, verify, commit

Start the dev server and exercise the flows, then validate and ship a clean commit:

  • /login, /signup, and a protected /dashboard now work end to end
  • /vk:eng:git scans for secrets and writes a conventional-commit message
npm run dev # then, in Claude Code: /vk:eng:test # run the suite /vk:eng:git cm # stage, secret-scan, commit, push

The feature cycle

Quick start is one turn of the standard Vikit loop — plan, implement, test, fix, ship:

/vk:eng:plan [feature] # research + plan Implement the plan # implement /vk:eng:test # validate /vk:eng:fix [issue] # quick fixes /vk:eng:git cm # commit

Go further

The same loop scales to bigger features — each takes minutes instead of days:

/vk:eng:implement add Stripe payments with subscriptions and webhooks /vk:eng:implement create a REST API with Zod validation /vk:eng:debug why /api/users returns 500 /vk:eng:brainstorm should I use REST or GraphQL?

Next steps