Carolers

Inspiration

Carolers was inspired by the timeless tradition of caroling and the desire
 to bring people together through the joy of singing festive songs. The
creators recognized that while caroling is a beloved tradition,
coordinating group singing events, selecting songs democratically, and
ensuring everyone knows the lyrics can be challenging. The app aims to
enhance this communal experience by leveraging modern technology to
facilitate connection, discovery, and participation in caroling
gatherings.

What it does

Carolers is an intuitive, festive app that enables users to gather singers
 and celebrate together through coordinated caroling events. The platform
offers:

 - Event Creation & Discovery: Users can create caroling gatherings or join
   existing ones
 - Democratic Song Selection: Participants can vote on which carols to sing
   at events
 - Comprehensive Lyrics Hub: Displays full lyrics optimized for outdoor
   venues with print and share capabilities
 - Preparation Guides: Offers theme context, song previews, and vocal range
   guidance
 - Event Recaps: Provides statistics, top songs, and social sharing features
 - Coordination Tools: Includes chat, contribution tracking, and
   gamification elements
 - AI-Powered Planning: Uses Gemini 3 for smart setlist suggestions and
   event planning
 - Cultural Analysis: Provides deep cultural and historical analysis of
   carols
 - Multilingual Support: Offers high-quality translations preserving rhythm
   and cultural context
 - Carol Creation: Allows users to generate original carols with Suno AI
   integration

How we built it

Carolers was built using a modern tech stack centered around the Next.js
App Router with TypeScript. The frontend leverages React 19, Tailwind CSS
for styling, and Framer Motion for animations. Authentication is powered
by Clerk, while the database uses TiDB Serverless MySQL with Drizzle ORM
for type-safe queries. The AI capabilities are implemented using Google's
Gemini 3 Pro and Flash models, with extended thinking capabilities for
deeper musical analysis. The Suno AI integration enables users to create
original carols with both lyrics and compositions. The application follows
 design principles emphasizing enhancement over creation of new
components, aggressive consolidation to prevent bloat, and modular,
performant architecture.

Challenges we ran into

Several significant challenges emerged during development:

 - AI Integration Complexity: Implementing Gemini 3's extended thinking
   capabilities required careful handling of reasoning transparency,
   ensuring users could see the "why" behind AI recommendations
 - Suno API Optimization: Managing rate limits (20 requests/10 seconds)
   required implementing smart throttling, intelligent polling with
   progressive intervals, and error recovery mechanisms
 - Multilingual Translation Quality: Preserving rhythm, cultural context,
   and singability when translating carols required sophisticated prompting
   strategies and validation systems
 - Real-time Coordination: Implementing event coordination without WebSocket
    complexity meant relying on efficient polling mechanisms
 - Database Migration: Managing schema evolution and ensuring data
   consistency across different environments required careful planning with
   Drizzle Kit
 - Performance Optimization: Ensuring smooth experience for outdoor venues
   with potentially limited connectivity required adaptive loading and
   caching strategies

Accomplishments that we're proud of

 - Unique AI Transparency: Successfully implemented Gemini 3's extended
   thinking with visible reasoning in the UI, making AI more trustworthy and
    educational
 - Community Translation System: Built a Wikipedia-style translation system
   with voting, proposals, and reputation-weighted contributions
 - Suno API Integration: Created a robust system for generating original
   carols with proper error handling, status tracking, and optimization
 - Scalable Architecture: Designed a system that handles 1,200+ active
   carolers with efficient database queries and caching
 - Multilingual Support: Implemented high-quality translations that preserve
    musical rhythm and cultural context
 - User Experience Flow: Created a seamless journey through three phases:
   BEFORE (preparation), DURING (singing), and AFTER (celebration/recap)

What we learned

 - AI Reasoning Value: Extended thinking capabilities in AI models provide
   significantly more value than simple responses, especially for creative
   and analytical tasks
 - Community Moderation: Distributed translation systems work well when
   combined with reputation systems and democratic voting
 - API Rate Limiting: Proper abstraction and throttling mechanisms are
   crucial for reliable third-party API integrations
 - User Engagement: Gamification and social features significantly increase
   user retention and participation in community events
 - Cultural Sensitivity: Music translation requires deep understanding of
   both linguistic and musical elements to maintain cultural authenticity
 - Mobile-First Design: Outdoor use cases require special attention to
   readability, accessibility, and offline capabilities

What's next for Carolers

 - Enhanced Mobile Experience: Optimizing for outdoor venues with improved
   readability and offline capabilities
 - Monetization Strategy: Developing sustainable revenue models based on
   user metrics and premium features
 - Advanced AI Features: Expanding Gemini 3 integration for even deeper
   musical analysis and personalized recommendations
 - Community Growth: Scaling the platform to support larger communities and
   international caroling traditions
 - Offline Capabilities: Adding offline lyric access for areas with poor
   connectivity
 - Integration Expansion: Exploring partnerships with music streaming
   services and other event platforms
 - Analytics Dashboard: Providing hosts with detailed insights about
   participation, engagement, and song popularity trends

Built With

• drizzle-kit
• javascript
• shadcn
• sql
• tailwind