AgentStart Documentation

Introduction

AgentStart is not just a collection of code. It is a strictly typed Next.js 15 architecture designed specifically to be manipulated by AI agents like Cursor. By enforcing strict patterns, we eliminate AI hallucination.

Quick Start

npm install
npm run dev

Database Setup

We use LibSQL for a seamless local development experience that scales instantly to the Edge via Turso.

npx drizzle-kit push

Authentication

Authentication is handled by Better-Auth. Magic links are configured out of the box. To enable Google OAuth, simply add your Google Client ID and Secret to your .env.local file.

Stripe Integration

Stripe webhooks are located at src/app/api/webhooks/stripe/route.ts. Add your Stripe Webhook Secret to the .env.local file to begin listening for successful checkout sessions.

The AI Engine

Your codebase includes hidden .cursorrules files. Do not delete them. When you ask your AI to build a new feature, it will read these rules to ensure it uses Server Components and Drizzle ORM correctly.