How sayahosea/braille works
braille is a Deno-hosted online braille course with account management, authenticated sessions, course lessons, quizzes, and per-account progress. A visitor enters through the Hono app; its middleware enforces session access, and course routes render lessons while quiz submissions are checked and progress is recorded. The graph also shows the account API and persistence layer. Source excerpts establish the main wiring; individual account handlers and several page/client details were not sampled, so their internal dependencies are not inferred.
Main entry points: Database.js Database access · main.js Hono app · API.js Account and quiz API · index.js Course index
Components 18
Web application
- Hono app
src/main.js - Page handlers
src/handlers/Routes.js - Account and quiz API
src/routers/API.js - Shared utilities
src/handlers/Util.js
Course learning
- Course router
src/routers/Courses.js - Course index
src/routes/courses/index.js - Lesson renderer
src/routes/courses/start.js - Course content
src/handlers/Courses.js - Quiz validation
src/api/quiz/validate.js
Accounts and sessions
- Session middleware
src/handlers/AuthPlugin.js - Account operations
src/api/account - Signed cookies
src/handlers/Cookie.js
Persistence
- Database access
src/handlers/Database.js - Account records
src/database/Account.js - Session records
src/database/Session.js - Course progress
src/database/Progress.js
Other components
- Visitor
- PostgreSQL
Connections 21
- Visitor → Hono app: requests pages
README.md - Hono app → Database access: initializes
src/main.js - Hono app → Session middleware: applies middleware
src/main.js - Hono app → Account and quiz API: mounts API
src/main.js - Hono app → Course router: mounts courses
src/main.js - Hono app → Page handlers: dispatches pages
src/main.js - Account and quiz API → Account operations: dispatches account routes
src/routers/API.js - Account and quiz API → Quiz validation: dispatches validation
src/routers/API.js - Course router → Course index: dispatches course index
src/routers/Courses.js - Course index → Lesson renderer: dispatches lesson
src/routes/courses/index.js - Course index → Course content: loads course metadata
src/routes/courses/index.js - Lesson renderer → Database access: reads progress
src/routes/courses/start.js - Lesson renderer → Shared utilities: renders lesson
src/routes/courses/start.js - Quiz validation → Course content: checks answers against
src/api/quiz/validate.js - Quiz validation → Database access: reads and updates progress
src/api/quiz/validate.js - Session middleware → Signed cookies: reads session cookie
src/handlers/AuthPlugin.js - Session middleware → Database access: checks session and account
src/handlers/AuthPlugin.js - Database access → Account records: exposes account operations
src/handlers/Database.js - Database access → Session records: exposes session operations
src/handlers/Database.js - Database access → Course progress: exposes progress operations
src/handlers/Database.js - Database access → PostgreSQL: queries
src/handlers/Database.js