Skip to content

Spec 03 Repository Layout

github-actions[bot] edited this page Oct 14, 2026 · 1 revision

Section of Quizzivy — Frontend Portal & Data Model Specification · Previous · Next

3. Repository layout

web/src/
├─ app/                      # shell: providers, router, error boundaries, guards/
├─ features/
│  ├─ auth/
│  ├─ join/                  # NEW: public class-code join flow
│  ├─ tests/                 # admin: authoring
│  ├─ question-bank/
│  ├─ media/                 # NEW: upload widget + asset picker
│  ├─ assignments/
│  ├─ attempts/              # admin: monitoring + grading
│  ├─ integrity/
│  ├─ students/
│  ├─ classes/
│  ├─ take-test/             # student: the engine
│  └─ results/
├─ components/
│  ├─ ui/                    # shadcn primitives
│  └─ shared/
├─ layouts/                  # TeacherLayout (shell/), StudentLayout, FocusLayout
├─ lib/                      # api/, i18n/, utils/, config.ts
├─ hooks/  stores/  styles/  main.tsx

Feature folder convention (src/features/<name>/): api.ts, schemas.ts, components/, pages/, store.ts (optional), index.ts (public exports only). Features import each other only via index.ts. components/shared never imports from features/.


Section of Quizzivy — Frontend Portal & Data Model Specification · Previous · Next


Generated from docs/quizzivy-spec-v0.3.md. Edit that file in the repository; changes made on this page are overwritten.

Home

Start here

Product

Implementation plan

Redesign (Phase R)

Setup and operations

Design

Team

Code READMEs

Clone this wiki locally