CodeFlow Website

Marketing website for CodeFlow AI built with Next.js.

Overview

This is the marketing website for CodeFlow AI, providing information about the platform, features, and getting started guides.

Technology Stack

• Framework: Next.js 16.x with App Router
• Language: TypeScript
• Styling: Tailwind CSS 4.x
• Testing: Vitest + React Testing Library
• Deployment: Azure Static Web Apps

Development

Prerequisites

• Node.js 18+
• npm or yarn

Getting Started

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

Testing

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage report
npm run test:coverage

Coverage Thresholds: 60% for statements, branches, functions, and lines.

Linting

# Run ESLint
npm run lint

Documentation

Comprehensive documentation is available in the docs/ directory:

Document	Description
Project Context	Business goals, target users, and user journeys
Design System	Design tokens, typography, colors, and component inventory
Architecture Overview	System architecture, data flow, and deployment pipeline
Tech Stack	Detailed technology breakdown by layer
Best Practices Benchmark	Industry standards and evaluation criteria
Audit Findings	Code audit results and recommendations
Technical Debt Registry	Tracked issues, priorities, and resolution status

Deployment

The website is deployed to Azure Static Web Apps. See codeflow-infrastructure for deployment infrastructure.

CI/CD Pipeline

The project uses GitHub Actions for continuous integration:

• Build: Compiles the Next.js application
• Test: Runs Vitest test suite (blocking)
• Lint: Runs ESLint checks (blocking)
• Deploy: Deploys to Azure Static Web Apps on push to main

Contributing

Code Quality Standards

1. TypeScript: All code must be properly typed
2. Testing: New features should include unit tests
3. Linting: Code must pass ESLint without errors
4. Accessibility: Follow WCAG 2.1 AA guidelines

Commit Message Format

Use semantic commit messages:

feat: add new feature
fix: resolve bug
docs: update documentation
test: add or update tests
refactor: code improvements without behavior change

Related Repositories

• codeflow-engine - Core engine
• codeflow-infrastructure - Production infrastructure
• codeflow-desktop - Desktop application (contains shared design system)
• codeflow-vscode-extension - VS Code extension
• codeflow-azure-setup - Azure bootstrap scripts

License

MIT