Skip to content

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

87 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DysgraphiMath

A smart digital math notebook designed to assist students with dysgraphia. Separates mathematical thinking from motor demand.

Warning

This is a DIY, Vibe-Coded Project!
DysgraphiMath was created as an assistive technology passion project. It is heavily vibe-coded (crafted in partnership with AI models) and is very much a Do-It-Yourself (DIY) tool. Use it entirely at your own risk. While the codebase is fully operational and has undergone security hardening, bugs may occur, calculations might occasionally drift into alternate dimensions, and AI tutors can sometimes exhibit quirky behaviors.

Four Modes

Think Out Loud

A voice scratchpad for externalizing mathematical reasoning. Students speak their thoughts freely, and AI organizes the transcript into clean mathematical reasoning without solving the problem. Supports multiple problems per session and PDF/TXT exports.

Clean Up My Work

Upload a photo of handwritten math work and get a clean, editable digital version. AI-powered handwriting recognition preserves layout, diagrams, and crossed-out work. Export as PDF or copy to clipboard.

Solve Step-by-Step

An AI-driven stepwise solver. Students drive the logic via natural language commands ("subtract 5", "divide by 2") while the engine handles formatting and arithmetic. Supports voice, text, drawing, and photo input.

Grid Paper

Generate printable grid or dot paper (A4/A3) with configurable cell sizes. Upload a problem set to create gridded worksheets with one problem per page and work space below.

Features

  • Multi-Modal Input: Voice, Text, Drawing, and Photo Upload
  • Multi-Problem Sessions: Queue up problems from a single upload and solve them one by one, or record multiple Think Out Loud problems in a row
  • Accessible & Soft Premium Bento Design: Modern rounded card style (12px) modeled after SciencePracticeApp with slate, amethyst-violet, and sunset-rose visual accents. Toggles light/dark modes with beautiful ambient shadow glows. Built-in modern readable typography (Outfit, Plus Jakarta Sans, JetBrains Mono) alongside togglable OpenDyslexic font support, line height controls, and dynamic math syntax highlighting.
  • Session Reports: Compact 2-column PDF reports of solver work or compiled Think Out Loud transcripts
  • Scaffolded Learning: Reference Shelf, Hint System, and AI Coach
  • Built-in Calculators: Integrated Desmos scientific and graphing calculators available alongside multiple modes
  • Student Name: Captured once on the landing page, used across all PDF outputs
  • iPad Ready: Installable as a PWA for a distraction-free experience

🔒 Secure & Zero-Exposure Architecture

DysgraphiMath is built to protect your credentials. Your Google Gemini API Key is never sent to the client browser or bundled in frontend assets:

  • Local Dev Proxy: During local development (npm run dev), a custom Vite proxy middleware redirects requests to the Gemini API securely using the local .env key.
  • Serverless API Proxy: In production, requests are handled via a serverless function endpoint (/api/gemini) that securely queries the Gemini API with your Vercel-configured environment variables.

🚀 Setup & Deployment

For a step-by-step walkthrough on setting up your local workspace, configuring your credentials, and deploying securely to Vercel, please consult the:

👉 Secure Deployment & Configuration Guide

Quick Local Start

  1. Clone the repository and install dependencies:
    npm install
  2. Create a .env file in the root directory:
    GEMINI_API_KEY=your_gemini_api_key_here
  3. Launch the secure local development server:
    npm run dev

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages