Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Yang-ao17/examprep-web

Repository files navigation

ExamPrep Web

Turn your exam materials into a study website.

Upload slides, PDFs, notes, past exams, or oral exam questions. ExamPrep Web turns them into a clickable study system with topic maps, past-question analysis, oral practice, source references, and a study plan.

No page building. No document chaos. Just a clearer path from "I have too much to study" to "I know what the exam is likely to test."

Next.js TypeScript Local First License

Exam materials → structured study system → clickable review website → oral exam practice

ExamPrep Web Overview

Stop turning exam prep into document chaos

Lecture slides in one folder. PDFs in another. Notes, question banks, rubrics, and past papers scattered everywhere.

ExamPrep Web turns those files into one structured review website, organized around what matters for the exam instead of the original order of the documents.

See the likely themes. Find the high-priority topics. Understand what past questions are really testing. Practice saying a strong answer out loud.

What it does

From messy materials To exam-ready practice
Build a study dashboard from uploaded course files Generate oral questions for every major topic
Extract text from TXT, PDF, DOCX, and PPTX Give mock feedback on spoken-style answers
Create topic maps based on exam relevance Explain past questions by what they test
Link every topic back to source chunks Create a study plan automatically
Rank likely exam themes and repeated questions Run locally without a cloud account or API key

Inside the study website

Upload exam materials

See the full Upload screen below. Explore the topic map
Exam-focused topic cards
Open source-grounded topic details
Topic detail with exam relevance Practice oral answers and get feedback
Oral practice answer feedback
Follow a focused study plan
Generated study plan Review from anywhere
ExamPrep Web mobile view

Upload TXT, PDF, DOCX, or PPTX materials

Built for students who need to prepare fast

ExamPrep Web is useful for:

  • Oral exams where knowing the answer is not enough; you need to explain it clearly
  • Final exams with too many lectures and no obvious review order
  • Open-book exams where finding the right concept quickly matters
  • Closed-book exams that demand confident recall
  • Presentation-based exams with follow-up questions
  • Courses with hundreds of slides and repeated themes
  • Students with past papers but no clear study structure

How it works

  1. Create an exam project with the course, exam type, date, and goal.
  2. Upload your materials or paste text manually.
  3. Generate your study website with one click.
  4. Review topics and past questions organized by exam relevance.
  5. Practice oral answers and get structured feedback.
  6. Follow the study plan until exam day.

Quick Start

Requirements

  • Node.js 20.16+ or a current Node.js LTS release
  • npm

Run locally

git clone https://github.com/YOUR_USERNAME/examprep-web.git
cd examprep-web
npm install
npm run dev

Then open:

http://localhost:3000

No API key is required for the current MVP.

Try the demo in 2 minutes

  1. Start the app.
  2. Create a new project.
  3. Upload examples/demo-marketing-exam.txt.
  4. Click Generate Study Website.
  5. Explore Overview, Topics, Past Questions, Oral Practice, and Study Plan.

Supported files

File type Status
TXT Supported
PDF Supported for text-based PDFs
DOCX Supported
PPTX Supported
Scanned PDFs Not yet supported, OCR planned

Current status

ExamPrep Web is an early open-source MVP with the complete local study flow working: uploading, file parsing, text chunking, local persistence, study website generation, oral practice, and study-plan tracking.

AI generation is currently mocked, so anyone can clone the project and experience the full product without configuring an API key. Real AI integration is planned, and the AI service layer is already separated for an easy upgrade.

Roadmap

  • Real OpenAI API integration
  • OCR for scanned PDFs
  • Better oral exam scoring and follow-up questions
  • Exportable study websites
  • Shareable study links
  • Multi-language support
  • Spaced repetition
  • Better topic ranking and question clustering
  • Hosted version

Privacy & security

  • The MVP runs locally and stores project data in data/examprep.json.
  • Do not commit real uploads or copyrighted course materials.
  • Do not commit API keys or .env files.
  • Keep local environment files private.
  • Use only materials you have permission to process.

For contributors

ExamPrep Web uses Next.js App Router, TypeScript, Tailwind CSS, Server Actions, and a small local JSON database.

The product flow stays intentionally simple:

Uploaded file
 → plain text parser
 → source-labeled chunks
 → study generation services
 → fixed review website

File parsers live in lib/parsers. Every parser returns the same ParsedFile shape, so TXT, PDF, DOCX, and PPTX all enter the same chunking pipeline.

Mock AI services live in lib/ai. To connect a real model, keep the existing typed function signatures and replace the internal mock logic with server-side API calls. The main orchestration entry point is lib/ai/generateStudySystem.ts.

Quality checks

npm run lint
npm run build

License

ExamPrep Web is licensed under AGPL-3.0-or-later.

If this project makes exam prep feel less chaotic, consider starring it and helping shape the roadmap.

About

Exam prep for any exam — turn materials into a study website, especially for oral exams.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle によって変換されたページ (->オリジナル) /