Learn Spanish (project name: garnet-learn) is a self-service web application for adult beginners who want to learn Spanish. The product's intent is narrow and concrete: a learner studies Spanish words and phrases in lessons, and can return in later sessions to continue learning from saved progress. The app is energetic and cultural rather than school-test-like, and it treats typography as the primary lesson surface.
This document is the System Requirements Document for the product. It defines the current delivery: a public entry surface, self-service identity establishment and return verification, a progress dashboard, a lesson experience, and a lesson result surface, all backed by application-owned persistent state.
Audience: the single active human persona, the Spanish learner — an adult beginner who wants to study Spanish vocabulary and phrases in short lessons and resume where they left off.
Learn Spanish is delivered as a React frontend, a shared FastAPI backend process, and a MariaDB database for application-owned persistent data. The frontend presents six first-party pages: Landing (public), Sign Up (public), Login (public), Dashboard (authenticated), Lesson (authenticated), and Lesson Result (authenticated). The backend owns learner identity, lesson content delivery, and saved progress; MariaDB stores accounts and per-learner lesson progress so that a learner can continue in later sessions.
The only active human actor is the Spanish learner. There are no other human roles, no instructors, no administrators, and no social or sharing participants. The system itself (backend process and database) is a non-persona actor that persists identity and progress.
Accepted current behavior:
Removed from scope
The product is a first-party, application-owned experience. Identity is application-owned: a learner creates an account through Sign Up, and a returning learner verifies identity through Login to reach saved progress. Landing, Sign Up, and Login are anonymously reachable; Dashboard, Lesson, and Lesson Result require a verified session. A protected page never establishes access to itself — the anonymous entry interactions live on Landing, Sign Up, and Login.
Current scope is limited to studying Spanish words and phrases in lessons and resuming saved progress across sessions. There is no speech recognition, no live tutoring, no social features, no instructor role, and no content authoring surface in the current delivery. Lesson content is delivered by the application backend.
FR-1 — Learn Spanish in the app (explicit) As a Spanish learner, I should be able to use the app to learn Spanish, so that I can build Spanish vocabulary and phrase knowledge.
FR-2 — Study Spanish words and phrases in lessons (explicit) As a Spanish learner, I should study Spanish words and phrases in lessons, so that I practice specific vocabulary and phrases.
FR-3 — Continue learning in later sessions (explicit) As a Spanish learner, I should be able to continue learning in later sessions, so that my progress is not lost when I leave and return.
FR-4 — Self-service enrollment before saved progress (required_inference) As a Spanish learner, I should complete self-service enrollment before any saved progress exists, so that my progress can be tied to my account.
FR-5 — Verify identity on return to reach saved progress (required_inference) As a Spanish learner, I should verify my identity when I return, so that I can reach my saved progress.
Muse and headline: Typography as architecture after Paula Scher — "Spanish, Set in Bold Letters."
Mode: Light mode.
Colour tokens (exact hex by role):
#F4EEDF#FFFFFF#111111#D8202A#F2B705#2E6E6ATypography:
Shape language: Hard edges only. Flat colour blocks, diagonal bands, and thick rules. No rounded cards and no shadows.
Layout: Asymmetric poster grid. A full-bleed word wall sits left; the sign-up block sits right on a red field. Numbered lesson rows use tabular alignment.
Imagery: Type is the image. High-contrast cut-out photos of hands, mouths, and street signs appear only as small accents.
Readability constraint: Headlines, wordmarks, labels, numbers, card text, and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling (for example font-size: clamp(...)) to fit, with no other element covering them. Decorative type, imagery, and motion may bleed, rotate, or overlap freely as long as they cover no readable text or control.
The public entry (Landing) is a full-height word wall: stacked Spanish words in Anton fill the left 60 percent of the viewport in black, red, and yellow on the warm paper ground, with some words rotated 90 degrees. The word wall is the dominant element. On the right, a solid red block holds the headline "Spanish, Set in Bold Letters", the subline "Study words and phrases in short lessons. Your progress waits for your next session.", and the "Start Learning" button. A red horizontal ticker of Spanish phrases runs under the hero. The concept recomposes only accepted content and controls — the product name, hero copy, and the Start Learning action — and introduces no new behavior or destination.
Interaction Model: Animated Motion Tempo: expressive Hero Dimensionality: flat
Landing Hero Motion Brief
#F4EEDF; left 60% filled with black, red, and yellow Anton words at varied scale, some rotated 90 degrees; right red #D8202A block with the headline, subline, and Start Learning button; a red ticker band beneath.prefers-reduced-motion.docker-compose.yml with the frontend, backend, and database services. Feature APIs extend the shared backend process; no additional services are required for the current scope.
Study words and phrases in short lessons. Your progress waits for your next session.
Start Learning
Study words and phrases in short lessons. Your progress waits for your next session.
Start Learning
No comments yet. Be the first!