Home

TTS — Time Table Selector

TTS lets FEUP students explore every valid combination of class schedules before the semester starts. Pick your course units, choose classes, and the planner shows the timetables that actually fit. Built and maintained by NIAEFEUP.

Production	https://tts.niaefeup.pt
Repository	https://github.com/NIAEFEUP/tts — Bun workspace monorepo
Issues	https://github.com/NIAEFEUP/tts/issues

Status (October 2026): the backend rewrite is in progress. Auth and the read-only catalog are live; planner sync, exchanges, admin and collaboration are designed but not built. 🚧 means the feature does not exist yet.

Start here

What is TTS	The problem, what the app does, and what exists today
Reading paths	Ordered guides for newcomers, backend, frontend, ops and reviewers
Glossary	The vocabulary: course, course unit, occurrence, class, option
API Catalog	The 19 live endpoints, auth rules, and the error contract

Reference

README · CONTRIBUTING · API design · Tech stack · Database · SIGARRA SDK

About this wiki

• Pages live in docs/wiki/ and are reviewed in the same PR as the code they describe.
• Status markers: ✅ implemented · 🧪 untested · 🚧 planned · 🔁 compat · 🗑 dropped.
• The page plan and what is still missing are tracked in #931.

Help

• Found a bug or want a feature? Open an issue.
• Not sure where to start? Read Reading paths or ask a coordinator — issues are assigned by the project manager, not self-assigned.

---

Last verified: 2026-10-27 · next review: 2027-01-27