MathworkMaker

AI-powered math worksheet generator for Grades 1–8. Pick a grade, topic, and difficulty — get a printable PDF with a mini lesson, 10 questions, and a full answer key, all generated by Claude AI.

Stack

• React + Vite + Tailwind CSS
• KaTeX for math rendering
• html2canvas + jsPDF for PDF export
• Google Gemini 1.5 Flash API (free tier) via a Vercel serverless proxy (key never in the browser)

Local Development

Install dependencies:

npm install
npm install -g vercel

Create a .env.local file (copy from .env.example) and add your Gemini API key (free at aistudio.google.com):

GEMINI_API_KEY=AIza...

Run locally with Vercel dev (required to serve the /api function):

vercel dev

The app will be available at http://localhost:3000.

Deployment (Vercel)

1. Push this repo to GitHub
2. Import into Vercel
3. Add GEMINI_API_KEY as an environment variable in your Vercel project settings
4. Deploy — Vercel auto-detects the Vite frontend and the api/ serverless function