Flash Sales Dashboard

A modern CRM and sales intelligence platform for managing Bitcoin adoption initiatives across Caribbean territories.

Quick Start

Prerequisites

• Node.js 18.x or higher
• npm 9.x or higher
• Supabase project

Installation

# Clone and install
git clone https://github.com/your-org/flash-sales.git
cd flash-sales
npm install

# Configure environment
cp .env.example .env.local
# Edit .env.local with your Supabase credentials

# Start development server
npm run dev

Visit http://localhost:3000 to see the app.

Key Features

• Real-Time CRM: Live collaboration with instant updates across all users
• Lead Management: Territory-specific intake forms with intelligent routing
• Sales Analytics: Performance dashboards and conversion tracking
• Launch Bonus Challenge: Gamified sales competitions with testimonial capture
• Multi-Territory Support: Jamaica, Cayman Islands, and Curaçao
• Testimonial System: Capture video, photo, and text testimonials with social media-style preview

Tech Stack

• Frontend: Next.js 14, React 18, TypeScript
• Backend: Supabase (PostgreSQL), GraphQL (Apollo)
• UI: Tailwind CSS, Radix UI, Chart.js
• State: TanStack Query, Zustand
• Forms: React Hook Form, Zod validation

Documentation

Document	Description
Development Guide	Local setup and coding standards
Architecture	System design and technical decisions
Deployment	Production deployment guide
Contributing	Contribution guidelines
API Reference	API endpoints and integration
Supabase Setup	Database configuration
Changelog	Version history

Development

# Development
npm run dev              # Start dev server
npm run build           # Build for production
npm start               # Start production server

# Testing
npm test                # Run tests
npm run lint            # Lint code

# Database
npm run supabase:setup  # Initialize Supabase
npm run supabase:types  # Generate types

Contributing

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

See CONTRIBUTING.md for details.

License

MIT License - © 2021 Island Bitcoin LLC. All rights reserved.