Premium client-acquisition website for an international software engineering consultancy.
- Next.js 15 — App Router, Server Components
- TypeScript — Strict mode
- Tailwind CSS v4 — CSS-first design tokens
- shadcn/ui — Component primitives
- Framer Motion — Subtle animations
- Lucide — Icons
# Install dependencies
npm install
# Start development server
npm run dev
# Type check
npm run typecheck
# Lint
npm run lint
# Format
npm run formatOpen http://localhost:3000.
| Document | Description |
|---|---|
| Project Vision | Purpose, positioning, success metrics |
| Development Roadmap | Phased implementation plan |
| Architecture | Stack, folder structure, patterns |
| Design System | Tokens, components, rules |
| Decisions | Architecture decision records |
| Changelog | Version history |
Copy .env.example to .env.local and set values:
cp .env.example .env.local| Command | Description |
|---|---|
npm run dev |
Development server (Turbopack) |
npm run build |
Production build |
npm run start |
Production server |
npm run lint |
ESLint check |
npm run lint:fix |
ESLint auto-fix |
npm run format |
Prettier format |
npm run format:check |
Prettier check |
npm run typecheck |
TypeScript check |
src/
├── app/ # Routes (thin pages)
├── components/ # ui/, layout/, common/
├── features/ # Domain modules
├── data/ # Static content
├── config/ # Site configuration
├── constants/ # Navigation, animation, layout
├── hooks/ # Shared hooks
├── lib/ # Utilities, SEO, animations
├── providers/ # Theme provider
├── styles/ # Global CSS and tokens
└── types/ # TypeScript interfaces
Optimized for Vercel. Set NEXT_PUBLIC_SITE_URL in production environment.
Private — All rights reserved.