TL;DR: Eventola = 60-second event microsites with AI content, realtime RSVPs, and instant QR tickets. Built fully on Appwrite Sites.

🔥 LIVE SITE • 📱 Mobile Optimized • ⚡ Real-time RSVPs

Quick Test: Visit the demo, see the live RSVP counter, try the AI generators!

Why Eventola will blow your mind:

🤖 AI-First Experience - Event descriptions and taglines generated instantly
⚡ Real-time Magic - Watch RSVP counters update live across all devices
🎨 4 Stunning Themes - Quantum, Warp, Classic, Minimal designs
🎟️ Instant QR Tickets - Professional tickets generated automatically
🔥 Sub-60s Setup - From idea to live event page in under a minute

Before Eventola: Hours of design work, developer costs, boring signup forms
After Eventola: 60 seconds → Professional event microsite with AI content & real-time features

🔐 Authentication System

// Secure session management with Appwrite
- Email/password authentication
- Protected dashboard routes  
- Persistent sessions across devices

📊 Database Architecture

// Smart data modeling
events_db/
├── events (11 attributes)
│   ├── Event details & metadata
│   ├── Theme & branding info
│   └── File references
└── rsvps (4 attributes)
    ├── Attendee information
    ├── Unique ticket IDs
    └── Event relationships

💾 Storage System

// Organized file management
Storage/
├── event-covers/ (Hero images)
└── event-logos/  (Brand assets)
    └── Public read, auth write

⚡ Realtime Magic

// Live updates without refresh
client.subscribe('databases.events_db.collections.rsvps.documents')
  .then(response => updateRSVPCount(response.payload))
// Instant social proof across all devices

Pro Tip: Each theme is fully responsive and includes dark/light mode variants!

• Node.js 18+
• Appwrite Cloud account (free)
• Google AI API key (optional for AI features)

# 1. Clone the magic
git clone https://github.com/iamaanahmad/eventola.git
cd eventola

# 2. Install dependencies  
npm install

# 3. Configure environment
cp .env.example .env.local
# Add your Appwrite credentials

# 4. Auto-setup backend (requires Appwrite API key)
npm run setup:appwrite

# 5. Launch 🚀
npm run dev

🎯 Visit: http://localhost:9002 (for development) or https://eventola.appwrite.network (live demo)

Create .env.local:

# Appwrite Configuration
APPWRITE_ENDPOINT=https://[YOUR-REGION].cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=your-project-id
APPWRITE_API_KEY=your-server-api-key

# AI Features (Optional)
GEMINI_API_KEY=your-google-ai-key

Our setup script creates everything automatically:

✅ Database: events_db
✅ Collections: events, rsvps  
✅ Storage: event-covers, event-logos
✅ Permissions: Properly configured
✅ Attributes: All 15 fields set up

Alternative: Manual setup instructions in docs/ folder

🚀 Live Demo: https://eventola.appwrite.network

Test Flow:

1. 📝 Register Account → Sign up as organizer
2. 🎨 Create Event → Choose Quantum theme
3. 🤖 Use AI Tools → Generate description & tagline
4. 📤 Upload Images → Add cover + logo
5. 🌐 View Live Page → See your microsite
6. 👥 Test RSVP → Watch counter update live
7. 🎟️ Get QR Ticket → Instant ticket generation

# Development server
npm run dev                    # Start with Turbopack

# Appwrite utilities  
npm run setup:appwrite        # Auto-setup backend
npm run test:appwrite         # Verify connection
npm run fix:permissions       # Fix collection permissions
npm run fix:storage          # Fix storage permissions

# AI development
npm run genkit:dev           # AI development mode
npm run genkit:watch         # Watch mode for AI

# Production
npm run build               # Build for production
npm run start              # Start production server

• ⚡ Page Load: <2s initial load
• 🔄 Real-time Updates: <100ms latency
• 📱 Mobile Score: 95+ Lighthouse
• 🎨 Theme Switch: Instant transitions
• 🤖 AI Generation: 2-5s response time

• 🛡️ Appwrite Security - Built-in auth & permissions
• 🔐 Type Safety - End-to-end TypeScript
• 📊 Scalable Database - Optimized queries & indexing
• ☁️ CDN Ready - Optimized assets & images
• 🌍 Global Deploy - Edge-ready architecture

✅ Complete Feature Set - Fully functional platform
✅ Error Handling - Graceful failures and user feedback
✅ Type Safety - End-to-end TypeScript implementation
✅ Performance - Optimized queries, lazy loading, image optimization
✅ Accessibility - ARIA labels, keyboard navigation, screen reader friendly
✅ Mobile Experience - Touch-optimized, responsive design

📧 Contact: [email protected]
🐙 GitHub: @iamaanahmad
🌐 Live Demo: https://eventola.appwrite.network

---

💝 Powered by Appwrite

This project showcases the incredible power and developer experience of Appwrite.
Every feature just works, and the integration is seamless. Keep building amazing tools!

---