Finishi: AI-Powered Learning Platform
Executive Summary
Finishi is a comprehensive AI-powered learning platform that transforms scattered self-learning into structured, goal-oriented educational journeys. The platform combines personalized learning paths, AI tutoring, progress tracking, and accountability features to help learners complete what they start.
The project encompasses five interconnected services: a learner-facing application, an administrative dashboard, a shared API backend, a marketing waitlist site, and supporting infrastructure—all built with modern, scalable technologies.
The Challenge
Self-directed learners face a common problem: abundant resources but no structure. Courses, tutorials, and content pile up, leading to:
Content overwhelm
Too many options with no clear direction
Lack of accountability
No streaks, reminders, or progress tracking
Incomplete learning
Starting many courses but finishing few
Finishi needed to solve these problems while delivering a polished experience across multiple user roles (learners and administrators) with AI-powered personalization at its core.
Solution Architecture
Multi-Service Platform Design
We architected Finishi as a distributed system with clear separation of concerns:
┌─────────────────────────────────────────────────────────────────┐ │ FINISHI PLATFORM │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │ │ │ Waitlist │ │ User │ │ Admin │ │ │ │ (Remix) │ │ (React) │ │ (React) │ │ │ │ │ │ │ │ │ │ │ │ Marketing │ │ Learning │ │ Content & User │ │ │ │ & Signups │ │ Experience │ │ Management │ │ │ └──────┬───────┘ └──────┬───────┘ └──────────┬───────────┘ │ │ │ │ │ │ │ └─────────────────┼──────────────────────┘ │ │ │ │ │ ┌───────▼───────┐ │ │ │ Shared API │ │ │ │ (Fastify) │ │ │ │ │ │ │ │ - Auth │ │ │ │ - Learning │ │ │ │ - AI/Chat │ │ │ │ - Billing │ │ │ │ - Admin │ │ │ └───────┬───────┘ │ │ │ │ │ ┌───────▼───────┐ │ │ │ Supabase │ │ │ │ (Postgres) │ │ │ └───────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘
Technology Stack
Frontend Applications
Backend Infrastructure
Core Features Delivered
AI-Powered Learning Experience
The platform's AI capabilities span multiple features:
AI Tutor Chat
- Multi-provider architecture with automatic fallback (Gemini → Groq → OpenRouter)
- Context-aware responses using lesson content and learner experience level
- Content guardrails ensuring on-topic, educational responses
- Per-user rate limiting to prevent abuse
AI Quiz Generation
- Dynamic quiz creation from any technology topic
- Configurable difficulty levels (beginner/intermediate/advanced)
- Structured JSON output for consistent rendering
AI Content Summarization
- Multiple summary styles: brief, detailed, bullet-points
- Topic validation ensuring technology-related content
Structured Learning Paths
- Skills Taxonomy — Hierarchical organization of technology topics
- Learning Paths — Curated sequences of courses and lessons
- Courses — Grouped lessons with progression tracking
- Lessons — Individual learning units with rich content (TipTap editor)
- Quizzes — Knowledge validation with explanations
Accountability & Engagement
- Streak Tracking — Daily learning streaks to build habits
- Focus Sessions — Pomodoro-style focused learning with statistics
- Progress Dashboards — Visual progress tracking across skills and paths
- Notifications — Push and in-app notifications for reminders
- Daily Plans — Personalized "today's learning" recommendations
Onboarding & Personalization
- Multi-step Onboarding — Goal setting, experience level, time commitment
- Personalized Paths — AI-generated learning recommendations based on goals
- Adaptive Content — Difficulty adjusted to learner's demonstrated level
Subscription & Billing
- Tiered Plans — Free, Pro, and Premium tiers with feature gating
- Flexible Billing — Monthly and annual subscription options
- Secure Payments — Encrypted payment configuration with adapter pattern
- Plan Enforcement — Middleware for feature-level access control
Administrative Dashboard
User Management
- User search, filtering, and detailed profiles
- Activity monitoring and engagement metrics
- Bulk email and broadcast notifications
Content Management
- Full CRUD for skills, courses, lessons, and learning paths
- Rich text lesson editor with code highlighting
- Quiz builder with multiple question types
- Content preview and publishing workflow
Analytics & Monitoring
- Platform KPIs: total users, active learners, completion rates
- Popular skills and learning paths
- Recent learner activity feed
- Request monitoring and system health
Event Management
- Tech events and community events scheduling
- Registration tracking
- Live session and recording management
Waitlist & Marketing
- Landing Page — Responsive, theme-aware marketing site
- Waitlist Signup — Email collection with duplicate detection
- Impression Tracking — Analytics for marketing effectiveness
- Dark/Light Mode — System-preference-aware theming
Technical Highlights
API Architecture
The API follows a modular, domain-driven design:
src/ ├── admin/ # Admin-specific routes and logic ├── ai/ # AI provider abstraction and routes ├── auth/ # Authentication (email, Google OAuth) ├── billing/ # Subscription management ├── events/ # Community and tech events ├── focus/ # Focus session tracking ├── learning/ # Courses, lessons, paths, quizzes, skills ├── monitoring/ # Request logging and system metrics ├── notifications/ # Push and in-app notifications ├── onboarding/ # User onboarding flow ├── shared/ # Plugins, middleware, utilities └── user/ # User profile and preferences
Each domain module is self-contained with:
- Route definitions with Zod schema validation
- Type definitions for request/response contracts
- Business logic isolated from HTTP handling
Authentication & Authorization
- JWT-based Auth with access and refresh tokens
- Google OAuth integration for social login
- Role-Based Access Control — User vs Admin permissions
- Plan-Based Gating — Feature access tied to subscription tier
AI Provider Abstraction
// Fallback chain configuration
AI_FALLBACK_CHAIN: 'gemini,groq,openrouter'
// Each provider implements a common interface:
interface AIProvider {
name: string
complete(options: CompletionOptions): Promise<CompletionResult>
assistantChat(options: AssistantOptions): Promise<AssistantResult>
}Deployment Pipeline
Automated CI/CD with GitHub Actions:
- Code push triggers build
- Docker image built via Cloud Build
- Image pushed to Artifact Registry
- Cloud Run service updated with zero-downtime deployment
- Environment variables injected from secrets
Results & Impact
Platform Capabilities
- 5 integrated services working as a cohesive platform
- 20+ API endpoint groups covering all learning domain needs
- 3 AI providers with intelligent fallback for reliability
- Real-time features via Supabase subscriptions
- Mobile-responsive interfaces across all applications
Developer Experience
- Full TypeScript — Catch errors at compile time
- Shared API contracts — Zod schemas used in both backend and frontend
- Hot module reload — Fast development iteration
- Structured logging — Easy debugging with Pino pretty-print
Scalability
- Serverless deployment — Auto-scaling with Cloud Run
- Stateless API — Horizontal scaling ready
- Database connection pooling — Supabase handles connection management
- Rate limiting — Protection against abuse at API and AI layers
Capabilities at a Glance
Conclusion
Finishi demonstrates Chelon Labs' capability to deliver complex, multi-service platforms that combine modern frontend frameworks, robust API architecture, AI integration, and cloud-native deployment. The project showcases expertise in:
- Full-Stack TypeScript Development
- AI Integration & Multi-Provider Strategies
- Cloud-Native Architecture (GCP)
- EdTech Domain Experience
- Modern React Ecosystem (Vite, Tailwind, Radix)
- API Design with Fastify & Zod
The platform is positioned to scale with user growth while maintaining the personalized, AI-powered learning experience that sets Finishi apart in the EdTech space.
Building an AI-powered product?
Chelon Labs helps companies build multi-service platforms with AI integration, cloud-native architecture, and modern frontend frameworks.
Discuss your project