Skip to content

About

React + TypeScript SPA for a course marketplace: catalog with filters, course player with per-lesson progress, instructor course builder. TanStack Query, Zustand, shadcn/ui.

Topics

Resources

Contributing

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

Ed-Tech Platform — Frontend

React + TypeScript single-page app for the Ed-Tech Platform: a course marketplace and learning experience where instructors publish video/document courses and students enroll and track their progress.

This is the frontend only. It talks to the Ed-Tech Platform backend (Express + Prisma + PostgreSQL) over a JSON API.

Live demo: on the sign-in page, click Demo student or Demo instructor, or sign in manually:

Role Email Password
Student demo.student@example.com Demo@1234
Instructor demo.instructor@example.com Demo@1234

Demo data is reset on every backend deploy.

Course catalog

Tech stack

  • React 18 + TypeScript + Vite
  • React Router v6 for routing (src/routes)
  • TanStack Query for all server state (src/hooks/queries)
  • Zustand (with persist) for auth state (src/hooks/use-auth.ts)
  • Tailwind CSS v4 + shadcn/ui + Radix primitives
  • framer-motion for animation

Deployment

Hosted on Vercel and auto-deployed from main. VITE_API_URL points at the production API (https://ed-tech-platform-backend-ten.vercel.app).

Features (v1)

  • Public course catalog with search, level/price filters, and pagination
  • Course detail pages with curriculum preview
  • Email/password signup and login (JWT, stored in localStorage)
  • Free-course enrollment
  • Course player with a curriculum sidebar, video/document lessons, and per-lesson progress tracking
  • Instructor flow: create course → add sections & lessons → publish
  • Student & instructor dashboards (overview + my courses)

Paid courses, quizzes, assignments, certificates, notifications, discussions, and the parent dashboard are out of scope for v1 (the backend schema reserves models for them, but they are not wired up).

Getting started

Prerequisites

  • Node.js 18+
  • The backend running locally (see Ed-Tech-Platform-backend) — it needs PostgreSQL 14+

Install & run

npm install
npm run dev      # Vite dev server at http://localhost:5173

By default the app calls the API at http://localhost:3000. To point it elsewhere, create a .env:

VITE_API_URL="http://localhost:3000"

Other scripts

npm run build    # type-check (tsc -b) + production build to dist/
npm run preview  # preview the production build
npm run lint     # ESLint

See docs/SETUP.md for full backend + frontend setup, and docs/ARCHITECTURE.md, docs/FLOW.md, docs/PRD.md for design details.

About

React + TypeScript SPA for a course marketplace: catalog with filters, course player with per-lesson progress, instructor course builder. TanStack Query, Zustand, shadcn/ui.

Topics

Resources

Contributing

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages