mirror of
https://github.com/leonvanzyl/agentic-coding-starter-kit.git
synced 2026-01-30 14:32:01 +00:00
61e98f23cf
Major improvements to AI integration and developer experience: ## OpenRouter Migration - Replaced @ai-sdk/openai with @openrouter/ai-sdk-provider - Updated chat API route to use OpenRouter for access to 100+ AI models - Changed environment variables from OPENAI_* to OPENROUTER_* - Updated default model from gpt-5-mini to openai/gpt-5-mini - Benefits: Users can now access multiple AI providers (OpenAI, Anthropic, etc.) through a single unified API ## Documentation Overhaul - Expanded CLAUDE.md from 3 lines to comprehensive 225-line guide - Added complete project structure, tech stack overview, and AI integration guidelines - Documented all environment variables, scripts, and common tasks - Added critical rules for AI assistants working with the codebase - Enhanced checkpoint command with detailed step-by-step instructions ## README Updates - Updated feature list to highlight OpenRouter integration - Revised setup instructions for OpenRouter API key acquisition - Updated environment variable examples and deployment configuration - Changed all OpenAI references to OpenRouter throughout documentation ## Create Command Updates - Bumped create-agentic-app version from 1.0.0 to 1.0.1 - Synchronized all template files with main project documentation - Updated template env.example and package.json with OpenRouter configuration ## Dependency Updates - Added @openrouter/ai-sdk-provider@^1.2.0 - Updated @ai-sdk/openai from ^2.0.53 to ^2.0.60 - Updated @ai-sdk/react from ^2.0.78 to ^2.0.86 - Updated ai from ^5.0.78 to ^5.0.86 - Updated better-auth from ^1.3.29 to ^1.3.34 - Updated drizzle-kit from ^0.31.5 to ^0.31.6 - Updated eslint from ^9.38.0 to ^9.39.0 - Various type definition updates Breaking Changes: - Projects must update environment variables from OPENAI_* to OPENROUTER_* - API keys must be obtained from openrouter.ai instead of platform.openai.com - Model names now follow OpenRouter format (e.g., "openai/gpt-5-mini") 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
create-agentic-app
Scaffold a new agentic AI application with Next.js, Better Auth, and AI SDK.
Usage
Create a new project in the current directory:
npx create-agentic-app@latest .
Create a new project in a subdirectory:
npx create-agentic-app@latest my-app
What's Included
This starter kit includes:
- Next.js 15 with App Router and Turbopack
- Better Auth for authentication (email/password, OAuth)
- AI SDK by Vercel for AI chat functionality
- Drizzle ORM with PostgreSQL database
- Tailwind CSS with shadcn/ui components
- TypeScript for type safety
- Dark mode support with next-themes
Next Steps
After creating your project:
- Update environment variables: Edit
.envwith your API keys and database credentials - Start the database:
docker compose up -d - Run migrations:
pnpm run db:migrate(ornpm/yarn) - Start dev server:
pnpm run dev
Visit http://localhost:3000 to see your app!
Publishing to npm
To publish this package to npm:
- Update package.json: Set your author, repository URL, and version in
create-agentic-app/package.json - Test locally (optional): Test the package before publishing:
cd create-agentic-app npm link cd /path/to/test/directory create-agentic-app my-test-app - Publish: The sync happens automatically!
The
cd create-agentic-app npm publishprepublishOnlyhook will automatically sync the template from the main project before publishing.
Template Updates
Automatic Sync (Recommended)
When publishing, the template syncs automatically via the prepublishOnly hook. Just run:
cd create-agentic-app
npm publish
Manual Sync
If you want to sync without publishing:
From the project root:
npm run sync-template
Or from the create-agentic-app directory:
npm run sync
The sync script automatically:
- Copies all files from the main project to
template/ - Excludes build artifacts (node_modules, .next, lock files, etc.)
- Removes
"private": truefrom template's package.json - Removes the
sync-templatescript (users don't need it)
Publishing Workflow
- Make changes to the main boilerplate project
- Test your changes
- Bump version in
create-agentic-app/package.json - Publish:
(Template syncs automatically before publishing)
cd create-agentic-app npm publish
License
MIT