Kraft AI

A modular recipe formulation and iteration platform built with Next.js, TypeScript, and Supabase.

Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Start with full server management (recommended)
npm run server

# Build for production
npm run build

# Start production server
npm run start

Project Structure

kraft-ai/
├── src/                  # Next.js application source
│   ├── app/             # App router pages
│   ├── components/      # React components
│   ├── lib/             # Utilities and libraries
│   └── modules/         # Feature modules
├── public/              # Static assets
├── database/            # Database schemas and migrations
├── scripts/             # Development scripts
├── mcp-servers/         # MCP server integrations
└── server.sh            # Main server management script

Tech Stack

• Frontend: Next.js 14, React 18, TypeScript
• Styling: Tailwind CSS, CSS Modules
• Database: Supabase (PostgreSQL)
• State Management: React Context + Zustand
• Testing: Jest, React Testing Library
• Development: pnpm workspaces, Turborepo

Available Interfaces

1. Terminal Interface - Retro terminal-style UI at /terminal
2. Module Interface - Modern module-based UI (default)
3. Document Interface - Document-centric view (in development)

Documentation

• Development Instructions - Detailed development guide
• Architecture Overview
• Development Guide

Environment Variables

Create a .env.local file in the root directory with:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key

# Development
NEXT_PUBLIC_USE_MOCK_DATA=false

Development

See CLAUDE.md for detailed development instructions including:

• Available npm scripts and server modes
• Database setup and operations
• Testing commands
• MCP integration options

Common Commands

# Database setup
npm run db:setup

# Run tests
npm test
npm run test:coverage

# Server management
npm run server:stop      # Stop all servers
npm run server:restart   # Restart all servers

License

MIT