R-Spec Auto & Performance — rspecperformance.com

One-page marketing site for R-Spec Auto & Performance, a full-service JDM specialty shop in Sacramento, CA. Next.js 16 (App Router) + TypeScript + Tailwind v4, deployed on Vercel.

Audience-specific entry points

• You're an AI agent (Claude, Cursor, Copilot, etc.)? Read CLAUDE.md first. It's your map.
• You're a human developer? Keep reading this README, then skim CLAUDE.md and docs/.
• You're Rav (the owner)? Open HANDOFF_FOR_RAV.md — plain English, no code.
• You need to deploy or debug hosting? DEPLOYMENT.md.

---

Quick start

pnpm install
cp .env.local.example .env.local   # fill in Resend key + contact email
pnpm dev                           # http://localhost:3000

Scripts

Command	What it does
pnpm dev	Dev server with Turbopack
pnpm build	Production build
pnpm start	Run the built app
pnpm lint	ESLint

Environment variables

See .env.local.example. Required in production:

• RESEND_API_KEY — transactional email delivery (owner notifications, customer confirmations, updates)
• CONTACT_TO_EMAIL — where inquiries land
• CONTACT_FROM_EMAIL — must be on a Resend-verified domain
• NEXT_PUBLIC_SITE_URL — e.g. https://rspecperformance.com
• DATABASE_URL — Postgres for bookings/CRM (free Neon instance via the Vercel Marketplace)
• AUTH_SECRET — signs the admin session cookie and customer portal links
• ADMIN_PASSCODE — the passcode for /admin/login

---

Documentation map

All the context a new contributor (human or AI) needs, grouped:

Always-relevant

• CLAUDE.md — AI / developer entry point. Stack, single-source-of-truth rule, 10 conventions.
• AGENTS.md — tool-agnostic agent instructions (Cursor, Copilot, Continue, etc.).

Deeper references (in docs/)

• docs/BUSINESS.md — company identity, audience, brand voice, positioning.
• docs/ARCHITECTURE.md — file-by-file tour, request flow, routing map.
• docs/CONVENTIONS.md — deep coding patterns with rationale.
• docs/CONTENT_GUIDE.md — voice, tone, SEO rules, copy templates.
• docs/ROADMAP.md — what's planned (now / next / later), what's deferred.
• docs/GLOSSARY.md — JDM / Nissan / tuning terminology.

Operational

• DEPLOYMENT.md — Vercel + Porkbun DNS + Resend walkthrough, ~30 min.
• ASSETS_NEEDED.md — checklist of photos/copy Rav owes the devs.
• HANDOFF_FOR_RAV.md — non-technical owner guide.
• GOOGLE_DOC.md — how to mirror handoff docs into a shared Google Doc.

---

Architecture (skim version)

app/        One-page home + /admin (shop CRM) + /portal (customer tracking), API routes, metadata
components/ React components — Server Components by default
lib/        Domain: site config, services array, db access (pg), auth tokens (jose), emails, zod schemas
public/     Static assets (brand badge, work photos/video)
docs/       Deeper internal documentation (see map above)

Full tour: docs/ARCHITECTURE.md.

---

Deploy

See DEPLOYMENT.md for the full step-by-step walkthrough (Vercel + Porkbun DNS + Resend domain verification). Budget ~30 minutes.

Every push to main auto-deploys to production. Every PR gets a preview URL.

---

License

Private. © RSpec Performance.