Klaussified
Full-featured Secret Santa web app with group management and gift tracking
- Web App
Overview
Klaussified is a comprehensive Secret Santa web application designed to take the hassle out of organizing gift exchanges. Built with Flutter Web and Firebase, it provides a modern, responsive interface for creating groups, managing members, and running Secret Santa events with smart assignment algorithms.
The app features a robust authentication system supporting email/password, Google, and Apple sign-in. Members can create and manage personal wishlists, while gift status tracking allows users to see who has already chosen their target—keeping everyone engaged and preventing duplicate selections.
A festive Christmas-themed design with Material Design 3 components creates an immersive holiday experience, while automated email notifications keep all participants informed about their assignments and group updates.
Technologies
- Flutter Web
- Dart
- Firebase Auth
- Cloud Firestore
- Firebase Functions
- Firebase Hosting
- BLoC Pattern
- go_router
- Material Design 3
- Freezed
- get_it
Key Features
- Create and manage Secret Santa groups with unlimited members
- Invite members via email with automated notifications
- Smart random assignments with exclusion rules support
- Personal wishlists with preferences for each participant
- Gift tracking with purchased and wrapped status indicators
- Multi-provider authentication (Email, Google, Apple)
- Address management for shipping physical gifts
- Admin panel for user management and system settings
Approach & Architecture
Klaussified follows clean architecture principles with a clear separation between business logic, data, and presentation layers. The BLoC (Business Logic Component) pattern manages state throughout the app, providing predictable state transitions and easy testability.
The data layer uses repository pattern to abstract Firebase operations, making it easy to swap data sources if needed. Models are generated using Freezed for immutability and automatic JSON serialization, while get_it and injectable handle dependency injection.
The UI is built with Material Design 3 components and a custom Christmas theme featuring festive reds and greens. go_router handles navigation with auth-aware redirects, ensuring users are always routed to appropriate screens based on their authentication state.
Firebase Cloud Functions power the email notification system, sending automated emails when users are invited to groups or when Secret Santa assignments are revealed. This serverless approach keeps operational costs low while ensuring reliable delivery.
Screenshots
