AI-powered jewelry photography platform with premium prompt generation

Jewelshot Studio is a professional SaaS platform for generating AI-powered jewelry photography using advanced prompt engineering and fal.ai's Nano Banana model.

• 🎨 Aurora Background - Premium animated gradient effects
• 🎯 Preset Mode - Quick 4-step prompt generation
• 🎛️ Advanced Mode - 12+ parameter control
• 📸 Image Upload - Direct integration with Supabase Storage
• 🤖 AI Generation - fal.ai Nano Banana integration
• 📱 Responsive Design - Desktop-first with mobile optimization

jewelshot/
├── src/
│   ├── app/              # Next.js App Router
│   ├── components/       # Atomic Design Pattern
│   │   ├── atoms/       # Basic components (AuroraBackground, Button, etc.)
│   │   ├── molecules/   # Composite components
│   │   ├── organisms/   # Complex components
│   │   └── templates/   # Page layouts
│   ├── features/        # Feature-based modules
│   ├── lib/             # External integrations (Supabase, fal.ai)
│   └── hooks/           # Custom React hooks

• Framework: Next.js 16 (App Router)
• Language: TypeScript 5
• Styling: Tailwind CSS 4
• State: Zustand
• Forms: React Hook Form + Zod
• Animations: Framer Motion
• Database: Supabase
• Storage: Supabase Storage
• AI: fal.ai (Nano Banana)
• Deployment: Netlify
• Testing: Vitest + React Testing Library

# Clone repository
git clone https://github.com/jewelshot/jewelshot.git

# Navigate to project
cd jewelshot

# Install dependencies
npm install

# Setup environment variables
cp .env.example .env.local
# Add your API keys:
# - NEXT_PUBLIC_SUPABASE_URL
# - NEXT_PUBLIC_SUPABASE_ANON_KEY
# - FAL_AI_API_KEY

# Run development server
npm run dev

Visit http://localhost:3000

# Development server
npm run dev

# Type checking
npm run type-check

# Linting
npm run lint
npm run lint:fix

# Formatting
npm run format
npm run format:check

# Build for production
npm run build

# Start production server
npm start

This project uses Conventional Commits:

feat(studio): add aurora background component
fix(auth): resolve login redirect issue
docs(readme): update installation guide
test(studio): add unit tests for prompt generator

Types: feat, fix, docs, style, refactor, test, chore, perf, ci

main            # Production-ready code
└── develop     # Integration branch
    ├── feature/studio-sidebar
    ├── feature/fal-ai-integration
    └── fix/animation-performance

See CONTRIBUTING.md for guidelines.

MIT License - see LICENSE file

• Documentation
• fal.ai Documentation
• Supabase Docs

Current Status: 🚧 In Development (Step 1: Aurora Background ✅)

Next Steps:

• Sidebar Component
• Project Context Form
• Preset Mode
• Advanced Mode
• fal.ai Integration
• Authentication & Database

Built with ❤️ by [Your Name]