Geopolitics is a web application built to help people stop doom scrolling and instead spend that time learning about geopolitics. The product replaces the reflexive, endless-feed habit with short, clear geopolitics reading sessions, and it keeps a personal record of what the learner has read so the time spent feels accounted for rather than lost.
The audience is a general learner — someone with no formal background in international affairs who wants to understand the world without being pulled into a scrolling feed. The app is deliberately calm and structured: it presents geopolitics content as discrete sessions with a beginning and an end, not as an infinite stream.
This document is the System Requirements Document for the project named Geopolitics (project identifier doom-scrolling-geopolitics).
Geopolitics is a React web front end backed by a shared FastAPI service and a MariaDB database. The application owns learner identity: a new learner enrolls with the app, and a returning learner verifies identity to reach saved session records. Learning content is geopolitics reading material presented one session at a time; the learner starts a session from a dashboard, reads it on a session surface, finishes it, and can review finished sessions on a progress surface.
The single active human actor is the Learner. The application itself owns identity, session records, and content delivery. There are no other human roles, no administrative surface, and no social or sharing surface.
Current delivery covers: a public landing page, self-service sign up, login, a dashboard to start sessions, a session reading surface with a finish action, and a progress surface listing finished sessions.
Removed from scope
The product's whole purpose is a deliberate alternative to doom scrolling. That intent shapes the delivery boundary: the app must present geopolitics learning as bounded sessions with a visible finish, and it must not reproduce the mechanics of an infinite feed. There is no endless stream, no autoplay of the next item, and no algorithmic "more" loop.
Access is application-owned. The Landing page is public and anonymous. Sign Up and Login are public identity-access surfaces. Dashboard, Session, and Progress require a verified learner identity, because each depends on durable, learner-specific session records that must remain bound to the correct person across visits.
All current work is first-party and delivered by the application. There are no provider-owned or external destinations in the current scope. Future ideas are kept out of current pages and acceptance (see Section 11).
FR-1 — Avoid doom scrolling (explicit) As a Learner, I should be able to spend my time in the app on bounded geopolitics sessions rather than an endless feed, so that I stop doom scrolling.
FR-2 — Learn geopolitics instead of scrolling (explicit) As a Learner, I should be able to read clear geopolitics content in a session and finish it with new knowledge, so that the time I would have spent scrolling becomes learning.
FR-3 — Self-service enrollment (required_inference) As a new Learner, I should be able to create an account with the app myself, so that my session records are kept and bound to me.
FR-4 — Returning verification (required_inference) As a returning Learner, I should be able to verify my identity, so that I can reach my saved session records.
FR-5 — Start a session (required_inference) As a Learner, I should be able to start a geopolitics session from Dashboard, so that I have a defined piece of learning to do.
FR-6 — Finish a session (required_inference) As a Learner, I should be able to finish a session, so that it is recorded as completed and my time is accounted for.
FR-7 — Review finished sessions (required_inference) As a Learner, I should be able to review the sessions I have finished, so that I can see what I have learned and return to learning.
Authoritative creative direction: Systematic clarity after Massimo Vignelli. The app must feel like a reliable map, not a feed.
Colour tokens (light mode)
| Role | Hex |
|---|---|
| Background | #F4F1EA |
| Surface | #FFFFFF |
| Text | #111111 |
| Primary | #D7261E |
| Accent | #F2B705 |
| Muted | #6E6A62 |
| Region/topic green | #1F7A4D |
Colour is sparse and coded, not decorative: signal red marks the primary action; yellow and green code regions and topics.
Typography
clamp() so headlines stay whole at 375px, 768px, and 1280px.Shape language
Layout
Imagery
Avoid: rounded cards and soft shadows; gradient blobs and glass panels; decorative photography; playful bounce animation; generic blue accent on white.
The public entry is a full-width poster. A stacked headline in 96px black Archivo fills the left 8 columns: "Trade the scroll for the world". A flat red schematic world-map diagram sits in the right 4 columns and bleeds off the right edge. A yellow rule runs under the headline, and the CTA sits as a solid red square button with uppercase label text below the rule: "Start learning". A colour-coded legend strip under the hero maps red, yellow, and green to topic groups. Section headers sit on a full-width 2px black rule with a numbered label in the left margin. The start-session control on Dashboard is the same solid red square with uppercase label text, carrying the poster language into the working surfaces. Readable text and controls stay whole at every viewport; the map diagram carries the bleed gesture instead.
Interaction Model: Static (direction) Motion Tempo: still Hero Dimensionality: flat
Landing Hero Motion Brief
prefers-reduced-motion, provide a usable static arrangement; the direction is already almost still.docker-compose.yml with frontend, backend, and database services. No additional services are required for the current workflows.
Read short, clear geopolitics sessions and keep a record of what you learn.
Three coded groups organise every session, so you always know where you are reading.

Read short, clear geopolitics sessions and keep a record of what you learn.
Three coded groups organise every session, so you always know where you are reading.
No comments yet. Be the first!