• AI-Powered Writing Studio - Advanced writing environment with multiple modes (Focus, Dark, Typewriter, Hemingway, Zen)
• Intelligent Chapter Generation - Generate complete chapters based on your story outline and characters
• Real-time AI Assistance - Context-aware writing suggestions, dialogue generation, and style improvements
• Character Architect - Build deep, complex characters with AI-assisted development
• World Building Atlas - Create rich, consistent fictional worlds
• Sakura Progress System - Beautiful visual progress tracking inspired by cherry blossom growth stages

• Next.js 15 App Router - Latest framework features for optimal performance
• TypeScript - Full type safety throughout the application
• Supabase Integration - Scalable backend with real-time capabilities
• Anthropic Claude API - State-of-the-art AI for natural, creative writing
• Responsive Design - Beautiful on all devices with Tailwind CSS
• Dark Mode Support - Easy on the eyes during long writing sessions

• Node.js 18+
• npm or yarn
• Supabase account
• Anthropic API key

1. Clone the repository

git clone https://github.com/nmang004/bookbloom.git
cd bookbloom

2. Install dependencies

npm install

3. Set up environment variables

cp .env.example .env.local

Edit .env.local with your credentials:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

# Anthropic Claude
ANTHROPIC_API_KEY=your_anthropic_api_key

# Optional: NextAuth
NEXTAUTH_SECRET=your_nextauth_secret
NEXTAUTH_URL=http://localhost:3000

4. Run the development server

npm run dev

Visit http://localhost:3000 to see your BookBloom instance!

bookbloom2/
├── src/
│   ├── app/              # Next.js 15 app directory
│   │   ├── api/          # API routes
│   │   ├── book/         # Book workbench pages
│   │   ├── dashboard/    # User dashboard
│   │   └── new/          # Book creation wizard
│   ├── components/       # React components
│   │   ├── character/    # Character management
│   │   ├── outline/      # Story outline tools
│   │   ├── ui/           # Reusable UI components
│   │   ├── worldbuilding/# World building tools
│   │   └── writing/      # Writing studio components
│   ├── lib/              # Utility functions and services
│   └── types/            # TypeScript type definitions
├── public/               # Static assets
└── docs/                 # Documentation

BookBloom follows the "Zen Garden Precision" design philosophy, combining:

• Japanese minimalist aesthetics
• Modern tech precision
• Contemplative user experience
• Sakura (cherry blossom) themed progress indicators

• Sakura Pink: #FFB6C1 - Primary accent
• Charcoal: #2C3E50 - Text and dark elements
• Zen White: #FAFAFA - Clean backgrounds
• Garden Green: #4CAF50 - Success states

1. Start a New Project

   • Click "Plant a New Story" on the dashboard
   • Enter your book idea (as simple as "A detective story in space")
   • Let AI help generate initial concepts

2. Develop Your Story

   • Use the Outline Generator to structure chapters
   • Create characters with the Character Architect
   • Build your world with the World Building Atlas

3. Write with AI Assistance

   • Open the Writing Studio for your focused writing space
   • Right-click any text for AI enhancement options
   • Use writing modes for different experiences

4. Track Your Progress

   • Watch your Sakura progress indicator bloom
   • Set daily word count goals
   • Celebrate milestones as your story grows

• Smart Continuation: AI continues your story naturally
• Style Matching: Maintains consistent voice and tone
• Dialogue Generation: Create natural character conversations
• Description Enhancement: Add sensory details and atmosphere
• Show Don't Tell: Convert exposition to engaging scenes

• Character consistency checking
• World-building rule validation
• Pacing and flow analysis
• Genre-specific recommendations

// Use design system colors
className="bg-sakura-500 text-white hover:bg-sakura-600"

// Apply Zen Garden spacing (8px grid)
className="space-y-8 p-6" // 32px spacing, 24px padding

// Modern Tech precision timing
className="transition-all duration-200 hover:scale-105"

// Sakura progress indicators
<SakuraProgressIndicator 
  status="writing" 
  progress={65} 
  size="medium" 
/>

• Follows design system color palette
• Uses 8px spacing grid (space-4, space-6, space-8, etc.)
• Implements proper typography hierarchy
• Includes hover/focus/active states (150-200ms timing)
• Supports dark mode variants
• Meets WCAG 2.1 AA accessibility standards
• Includes proper ARIA labels and keyboard navigation
• Responsive across all breakpoints (sm, md, lg, xl, 2xl)

// Standard AI service usage
import { generateAIContent } from '@/lib/ai-service'

const result = await generateAIContent({
  type: 'synopsis' | 'outline' | 'chapter' | 'character' | 'worldbuilding' | 'rewrite' | 'continue',
  idea: string,
  genre: string,
  // Additional context based on type
})

// Error handling with user-friendly messages
try {
  const content = await generateAIContent(request)
  // Handle success
} catch (error) {
  // Use design system error states
  toast.error("The AI Muse needs a moment to gather inspiration...")
}

src/
├── app/                    # Next.js App Router
│   ├── page.tsx           # Homepage
│   ├── dashboard/         # Dashboard pages
│   └── api/ai/generate/   # AI endpoints
├── components/
│   ├── ui/               # shadcn/ui base components
│   ├── sakura/           # Custom Sakura-themed components
│   └── layout/           # Layout components
├── lib/
│   ├── ai-service.ts     # AI integration
│   ├── utils.ts          # Utility functions
│   └── validations.ts    # Zod schemas
└── types/
    ├── ai.ts             # AI-related types
    └── book.ts           # Book-related types

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint
• npm run db:push - Push schema to database
• npm run db:studio - Open Prisma Studio

1. Connect your GitHub repository to Vercel
2. Set environment variables in Vercel dashboard
3. Deploy automatically on push to main

1. Connect repository to Railway
2. Configure environment variables
3. Deploy API routes and background workers

1. Create new Supabase project
2. Copy connection strings to environment variables
3. Run database migrations

See .env.example for required environment variables:

• Supabase: Database and authentication
• Anthropic: AI generation capabilities
• Railway: Backend service hosting
• Vercel: Frontend deployment

npm test

npm run build

npm run lint
npm run type-check

• Collaborative writing with real-time sync
• Export to multiple formats (EPUB, PDF, DOCX)
• Advanced AI character dialogue training
• Writing analytics and insights
• Mobile app for writing on the go
• Community marketplace for prompts and templates

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Anthropic for Claude AI capabilities
• Vercel for Next.js framework
• Supabase for backend infrastructure
• Tailwind CSS for styling system
• The creative writing community for inspiration

• 📧 Email: support@bookbloom.app
• 💬 Discord: Join our community
• 📚 Documentation: docs.bookbloom.app