CS Learning Platform

A local-first training system for computer science classes, optimized for Networking and Database Concepts.

This app is built around the loop that actually improves exam and interview performance:

1. Active recall
2. Immediate feedback
3. Repetition of weak areas
4. Fast concept compression into one-page sheets

What you get

• Daily Drill Engine

  • Adaptive question sessions (10/15/20 minutes)
  • Networking + database concept prompts
  • Generated subnetting calculation drills
  • Self-grading (Again, Hard, Good, Easy) with weak-topic tracking

• 1-Page Topic Builder

  • Generates a compact study page with:
    • 5-bullet summary
    • key terms
    • misconceptions
    • practice questions (answers hidden)
    • 10-minute mini-lab

• Markdown -> Anki Export

  • Paste notes using Q: / A: blocks
  • Export cards as CSV for Anki import

• Progress Tracking

  • Current streak
  • Best streak
  • Accuracy and weak topics
  • Stored in browser localStorage (no backend required)

Tech stack

• TypeScript
• Vite (static build)
• Vanilla HTML/CSS/TS (no framework lock-in)

Quick start

npm install
npm run dev

Open http://localhost:5173.

Build production assets:

npm run build
npm run preview

Notes format for Anki export

Use this structure:

## Subnetting
Q: What is the broadcast address of 192.168.1.0/26?
A: 192.168.1.63

Q: Why subtract 2 from host count?
A: One address is network and one is broadcast.

The app parses each Q:/A: pair and exports a CSV with Front,Back,Tags.

Deployment

This project is static and free-tier friendly.

• GitHub Pages: recommended for zero-cost hosting tied to this repo
• Vercel: one-click deploy for faster previews
• Railway: works, but unnecessary for a static frontend

Detailed steps are in docs/DEPLOYMENT.md.

Project structure

src/
  data/
    questions.ts          # concept question bank
    topicTemplates.ts     # topic sheet templates + fallback generator
  lib/
    anki.ts               # markdown parser + CSV export
    drill.ts              # adaptive session builder
    storage.ts            # local progress persistence
    subnet.ts             # subnetting question generator
  main.ts                 # UI + interaction state
  style.css               # visual system

Roadmap

• SQL query execution mode with local DB sandbox
• Lecture note importer from markdown files
• Weekly cumulative quiz mode
• Optional account sync for multi-device progress

License

MIT