Tutorlog – Tutoring Studio Ledger (React Source Code)

Description

Tutorlog is a local ledger for a tutoring studio. It tracks students, sessions, and a prepaid hour bank. Rates are a price list for your notes. The app does not take payment and does not sync.

Features

• Today, students, sessions, and settings screens
• Prepaid hour bank updated when a session is marked held
• Studio name, tutor name, currency label, and accent on the Settings screen
• Sample students and sessions you can replace

Tech stack

• React and Vite
• TypeScript
• localStorage

Requirements

• Node.js 22 or newer
• npm 10 or newer

How to install and run

1. Unzip the archive and open the folder
2. Run npm install, then npm run dev
3. Checks: npm test, npm run lint, npm run typecheck, npm run build, and npm run preview

How to rebrand

• Studio name, tutor name, currency label, and accent: Settings
• Sample students and sessions: src/seed.ts
• Colors: :root in src/index.css
• Title: index.html
• Storage key: STORAGE_KEY in src/storage.ts

What’s included

• Full React / Vite source
• Unit tests, lint, and typecheck setup
• README with install, rebrand, and project layout
• LICENSE (one end product)

Limitations

• Data stays in localStorage on one browser.
• The hour bank is arithmetic on sessions you mark held. Cancelled and planned sessions do not reduce it.
• There is no invoice, tax, card payment, calendar sync, or login.
• The currency field is a label, not a payment currency.

License

Commercial license: use the source in one end product (one app, site, or service) for yourself or one client, free or paid. Reselling or publishing the source as a template is not allowed. Full text is in the LICENSE file.