挑战
Building a reliable tutoring marketplace required solving multiple integration challenges:
- Scheduling Complexity — Coordinating tutor availability with student bookings required real-time calendar synchronization
- Payment Flows — Managing subscriptions, one-time payments, and tutor payouts through a single payment system
- Authentication — Secure multi-role access for students, tutors, and administrators
- Form Reliability — Complex booking and onboarding forms needed strong validation to prevent errors and ensure data quality
- Real-Time Updates — Students and tutors needed instant feedback on booking changes and platform events
我们的解决方案
We built a full-stack tutoring platform using Supabase for authentication and real-time data, Stripe for subscription billing and tutor payouts, and Calendly for scheduling — all wrapped in a modern React/TypeScript frontend.
Architecture
- Frontend: React with TypeScript, TailwindCSS, and Shadcn/UI component library
- Build Tool: Vite for fast development and optimized production builds
- Backend: Supabase Edge Functions for secure API endpoints handling bookings, payments, and onboarding
- Database: Supabase (PostgreSQL) with real-time subscriptions for live updates
- Authentication: Supabase Auth with role-based access
- Scheduling: Calendly integration for real-time booking synchronization
- Payments: Stripe for subscriptions, one-time payments, and tutor payouts
- State Management: Redux Toolkit for global state, React Query for server state
- Form Validation: React Hook Form with Zod schema validation
- Animations: Framer Motion for transitions, loaders, and modals
Key Features
- Subscription System — Stripe-powered plans with recurring billing and free tier support
- Real-Time Scheduling — Calendly integration for booking synchronization between students and tutors
- Supabase Edge Functions — Serverless API endpoints for bookings, payments, and onboarding logic
- Form Validation — React Hook Form with Zod schemas preventing submission errors
- Tutor Payouts — Automated payout processing through Stripe Connect
- Live Updates — Supabase real-time subscriptions for instant booking and status changes
- Responsive Design — Mobile-friendly UI with Framer Motion animations and accessible modals
- Automated Deployment — CI/CD pipeline for stable and consistent releases
成果
技术栈
常见问题
MicrocosmWorks built the scheduling engine to store all availability in UTC and render it in the user's local timezone using the IANA timezone database. The system also handles daylight saving transitions automatically and displays overlap windows when a student in one timezone searches for tutors in another.
MicrocosmWorks designed an automated rescheduling workflow that immediately notifies the student, offers available replacement tutors with matching subject expertise, and credits the session back if no suitable alternative is found. Tutors who cancel repeatedly are flagged in the reliability scoring system.
MicrocosmWorks implemented a flexible credit-based subscription system where students purchase monthly hour bundles that roll over for up to 60 days. The platform supports mid-cycle upgrades and downgrades with prorated billing handled through Stripe's subscription scheduling API.
Yes, MicrocosmWorks built the video infrastructure using WebRTC with an SFU (Selective Forwarding Unit) architecture that scales from 1:1 sessions to group sessions of up to 8 participants. Group sessions consume fewer credits per student, incentivizing collaborative learning while maintaining tutor earnings.
MicrocosmWorks typically delivers tutoring platforms at development rates of $15-$40/hr, with the full scope including video integration, scheduling, payments, and tutor matching requiring 600-900 hours. The WebRTC infrastructure can be deployed on cost-effective cloud instances, keeping ongoing operational costs low.