code-kickstart

Code Kickstart 🚀

A CLI generator for bootstrapping modern web projects with Next.js, Shadcn/ui, and AI examples. Perfect for getting started quickly with Claude Code!

Features

• ✅ Interactive CLI - Choose your template with guided prompts
• ✅ Next.js 15+ with TypeScript and Tailwind CSS
• ✅ Shadcn/ui components pre-configured
• ✅ AI Examples using Vercel AI SDK
• ✅ Git initialized with commits
• ✅ Zero configuration - works out of the box

Quick Start

# Install globally
npm install -g code-kickstart

# Create a new project (interactive)
code-kickstart

# Or use direct commands
code-kickstart init my-app        # Simple starter
code-kickstart ai my-ai-app       # AI-powered app

Templates

🎯 Simple Starter

Perfect for beginners learning Claude Code:

• Next.js 15+ with TypeScript
• Tailwind CSS styling
• Shadcn/ui component examples
• Interactive demos (buttons, cards, forms)

🤖 AI-Powered

Advanced examples with AI capabilities:

• All simple starter features
• Vercel AI SDK integration
• Chat with streaming responses
• Text improvement tool
• AI idea generator
• Ready for OpenAI API

Usage

Interactive Mode (Recommended)

code-kickstart

Guides you through project name and template selection.

Direct Commands

code-kickstart init <project-name>    # Simple starter
code-kickstart ai <project-name>      # AI examples
code-kickstart help                   # Show help

AI Setup (for AI template)

• Get your OpenAI API key from OpenAI Platform
• Create .env.local in your project:

  echo "OPENAI_API_KEY=your-key-here" > .env.local
  

• Start development:

  npm run dev
  

Examples

Simple Project

code-kickstart init my-blog
cd my-blog
npm run dev

AI-Powered Project

code-kickstart ai my-ai-app
cd my-ai-app
echo "OPENAI_API_KEY=sk-..." > .env.local
npm run dev

What's Included

Both templates include:

• Next.js 15+ with App Router
• TypeScript configuration
• Tailwind CSS
• ESLint configuration
• Shadcn/ui components
• Git repository with initial commits

AI template additionally includes:

• Vercel AI SDK
• OpenAI integration
• Chat interface with streaming
• Text improvement tool
• Idea generator
• Structured AI outputs with Zod

Requirements

• Node.js 18+
• npm or yarn

Contributing

This tool is designed for learning and rapid prototyping. Feel free to fork and customize for your needs!

License

Private - All rights reserved