Portfolio — Product Engineering Partner

Premium client-acquisition website for an international software engineering consultancy.

Stack

• 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

Getting Started

# Install dependencies
npm install

# Start development server
npm run dev

# Type check
npm run typecheck

# Lint
npm run lint

# Format
npm run format

Open http://localhost:3000.

Project Documentation

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

Environment Variables

Copy .env.example to .env.local and set values:

cp .env.example .env.local

Scripts

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

Architecture

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

Deployment

Optimized for Vercel. Set NEXT_PUBLIC_SITE_URL in production environment.

License

Private — All rights reserved.