Agentic Web Starter Kit

A production-ready Next.js starter kit with Cedar-OS chat UI and Mastra agent orchestration. Includes a complete AI-powered task manager demo showing agentic patterns in action.

What's inside the kit

This starter kit provides everything you need to build and ship agentic web applications fast. It includes:

• Complete demo application - AI-powered task manager with Trello-style kanban board
• Production-ready patterns - Error handling, streaming, thread management, and more
• Modern tech stack - Cedar-OS, Mastra, Next.js 15, React 19, TypeScript
• Comprehensive documentation - Guides for every feature in the /docs folder

Perfect for developers who want to build AI-native applications where agents control state and UI through natural language.

What you get

Demo Application: AI Task Manager

• Trello-style kanban board - 4 columns (To Do, In Progress, Review, Completed)
• Natural language control - Create and manage tasks through conversation
• Smooth animations - Framer Motion powered transitions
• Priority & tags system - Color-coded priorities and flexible tagging
• Thread-scoped boards - Each conversation has its own isolated task board

Core Features

• Cedar-OS chat UI - Beautiful, modern chat interface with thread management
• Mastra agent orchestration - Type-safe workflows and tool execution
• Real-time streaming - Server-sent events (SSE) with progress updates
• Multi-thread conversations - Cedar-native thread management with persistence
• Web search integration - Built-in Exa.ai for real-time web search
• Auth0 ready - Optional Auth0 for AI Agents integration
• Production error handling - Error boundaries and retry logic
• Flexible storage - localStorage (dev) or Supabase (production)

Developer Experience

• TypeScript everywhere - Full type safety across frontend and backend
• Monorepo structure - Clean separation with shared types
• Hot reload - Fast development with Next.js and Mastra
• Comprehensive docs - Setup, architecture, tools, auth, deployment guides
• Example tools - Web search and task management tools included
• Environment templates - Easy configuration with env.template

Technology Stack

• Frontend: Next.js 15, React 19, TypeScript, Tailwind CSS
• UI: Cedar-OS components, Radix UI, Lucide Icons
• Backend: Mastra workflows and agents
• LLM: OpenAI SDK (GPT-4 recommended)
• Optional: Exa.ai (search), Auth0 (auth), Supabase (storage)

Who is this for?

• Developers building agentic web apps - Get production-ready patterns and examples
• Teams wanting to ship fast - Skip the boilerplate, start with working code
• Learners exploring the agentic web - Study a complete reference implementation
• Anyone migrating from CopilotKit - See how Cedar-OS + Mastra works together

Next steps

Once you have the starter kit running:

1. Try the demo - Chat with the AI task assistant to see agentic patterns in action
2. Explore the code - Study how tools, agents, and workflows are structured
3. Add custom tools - Build your own tools using the examples as templates
4. Enable web search - Add an Exa.ai API key to unlock search capabilities
5. Set up persistence - Configure Supabase for production chat history
6. Add authentication - Secure your app with Auth0 for AI Agents
7. Deploy - Ship to Vercel, Netlify, or self-host

Quick Start Guide

Prerequisites: Node.js 18+, OpenAI API key

# Clone and install
git clone <repository-url>
cd agentic-web-starter-kit
pnpm install
cd src/backend && pnpm install && cd ../..

# Configure environment
cp env.template .env
# Add OPENAI_API_KEY to .env

# Start dev servers
pnpm dev
# Frontend: http://localhost:3000
# Backend: http://localhost:4111

Try these prompts:

• "Create a task to review the Q4 budget in the Review column"
• "Add three tasks for the new website project"
• "Move all high priority tasks to In Progress"