Inspiration

I watched my sister, a full-time nurse working 12-hour shifts and mother of three (grades 3 through high school) struggle each night to help her kids with math and science homework. She’d flip through textbooks and Google concepts for hours just to confirm answers or retrace steps. I realized she was not alone: millions of parents juggle demanding jobs and complex subjects without the time or energy to check homework confidently.

What it does

Home Work Checker lets parents snap a photo of their child’s homework and instantly:

  • 🟢 Confirm whether the answer is correct
  • 💬 Provide a concise explanation of why it’s right or wrong
  • 🔄 If wrong, offer step-by-step guidance without revealing the final answer

How we built it

  • Frontend: React + TypeScript SPA (Vite, Tailwind CSS, Framer Motion, React Router)
  • Backend & Auth: Supabase (PostgreSQL, Auth, Storage, Edge Functions)
  • AI Integration: OpenAI GPT-4o vision model (image → JSON: correctness, explanation, guidance)
  • Payments: Stripe subscription ($7 / mo after 15 free checks) via Stripe.js & webhooks
  • Deployment: Netlify for frontend; Supabase edge functions for backend logic

Challenges we ran into

  • 🔍 Image analysis: teaching GPT-4o to parse handwritten text, extract question vs. student answer
  • 💳 Paywall logic: enforcing “15 free checks” on client & server before triggering Stripe checkout
  • Performance: minimizing image upload latency and API round-trips for a smooth UX
  • 🎨 Responsive design: building an intuitive dashboard on desktop and mobile

Accomplishments that we’re proud of

  • ✅ Reliable AI-driven homework validation with >90 % accuracy on test scans
  • ✅ Seamless Stripe subscription flow and customer-portal integration
  • ✅ Interactive progress dashboard: charts of correct vs. incorrect answers over time
  • ✅ Accessible, responsive UI themed in Medium’s green, black, and white

What we learned

  • Effective prompt-engineering drastically improved GPT-4o’s ability to interpret handwritten math
  • Supabase edge functions simplify serverless payment-and-webhook workflows
  • Framer Motion + Tailwind deliver performant, delightful animations with minimal overhead
  • User feedback loops accelerate refinements in onboarding, error-handling, and mobile layouts

What’s next for Home Work Checker

  1. Subject expansion: add science-diagram analysis (e.g., labeling biology sketches)
  2. Multi-language support: homework checks in Spanish, French, and more
  3. Parental insights: deeper analytics on topic mastery and personalized study plans
  4. Mobile app: native iOS/Android companion for offline scans and push notifications
    Try here

Built With

  • auth
  • chart.js-&-react-chartjs-2
  • edge-functions)
  • framer-motion
  • lucide-react
  • netlify
  • openai-gpt-4o-api
  • react
  • react-dropzone
  • react-hook-form
  • react-katex-&-katex
  • react-router-dom
  • storage
  • stripe-(stripe.js-&-webhooks)
  • supabase-(postgresql
  • tailwind-css
  • tanstack/react-query
  • typescript
  • vite
+ 48 more
Share this project:

Updates