Atom is a single-slide science explainer about the atom. The product exists to give a casual public viewer one calm, self-contained frame that shows what an atom is made of — the nucleus, the shells, and the electrons — and states a few clear facts alongside it. There is exactly one slide, and that slide is the whole product.
The audience is the casual viewer who arrives with no prior context and no account: a member of the public curious about the atom, reading the slide once, in one sitting, on whatever screen they have. The experience is a public entry surface, not a course, a tool, or a library of content.
This document is the System Requirements Document for Atom. It records the accepted product intent, the single-slide constraint, the one public page, the viewer's journey, and the visual and technical direction that make the slide legible and calm.
Atom delivers one full-viewport slide about the atom. The slide is the public entry and the only destination. A viewer opens it, reads a headline, sees a live generative atom rendered in real time, and reads three short fact rows. Nothing else is required of them, and nothing else is offered.
The product has one active human actor, the Slide Viewer, who reads the slide and takes away a short science explainer. There are no other human participants: no author, editor, moderator, or administrator is part of the accepted product. The only non-human actor is the rendering runtime that draws the atom on the viewer's device.
Delivery is a first-party custom web UI: a React frontend that renders the slide, a shared FastAPI backend that serves the slide's content, and a MariaDB database that holds that content. The backend and database exist to serve the one slide's facts; they do not introduce accounts, roles, or user-generated content.
Removed from scope
Atom is a public, read-only explainer. The single slide is anonymously reachable: a viewer needs no identity, no invitation, and no setup to read it. Because the viewer's work is a one-time read with no durable personal state, no commitment, and no value transfer bound to a person, the product establishes no application-owned identity and no session continuity. There is no sign-in, no registration, and no returning verification.
The one-slide limit is a hard product boundary, not a starting point. The current delivery is exactly one page, Atom Slide, which is both the public entry and the slide itself. There is no separate landing page, no index, and no "next" destination. The call to action on the slide ("Read the slide") moves the viewer within the same single frame to the fact content; it does not open a second page.
The backend and database are delivery infrastructure for the slide's content, not a viewer-facing capability. Future ideas about additional slides or deeper material are out of scope for this delivery and are not represented in any current page.
The single public page. It is one full-viewport frame, anonymously reachable, with no navigation away from it.
Information and state
Primary actions
Supporting actions
Domain entities
Component responsibilities
prefers-reduced-motion by presenting a static arrangement.States
FR-1 — One slide about the atom As a Slide Viewer, I should see exactly one slide about the atom, so that the whole product is a single self-contained frame.
FR-2 — Science explainer content on the slide As a Slide Viewer, I should get a short science explainer of the atom on the slide, so that I understand the nucleus, the shells, and the electrons.
FR-3 — Read the slide As a Slide Viewer, I should be able to act on "Read the slide" to reach the fact content, so that the explainer is easy to enter.
FR-4 — Slide content loading and recovery As a Slide Viewer, I should still get a usable slide if its facts are slow or fail to load, so that the explainer is never a blank frame.
FR-5 — Live generative atom As a Slide Viewer, I should see a live generative atom on the slide, so that the structure of the atom is shown rather than only described.
prefers-reduced-motion the atom is drawn as a static composition.Product context. The Slide Viewer is a member of the casual public who arrives at Atom with no account and no prior context. They have one frame in front of them and a short amount of attention to give it. They are not a student following a curriculum and not a researcher checking a source; they want a clear, calm answer to "what is an atom made of?"
Primary goal. Understand, in one read, that an atom has a nucleus, shells, and electrons, and take away a few concrete facts about them.
Distinct accepted responsibilities. The Slide Viewer is the only human actor. Their work is to open the single slide, read the headline and subline, look at the live atom, and read the three fact rows. They make no decisions that change product state, submit nothing, and own no durable record. This is what makes the role different from a typical application user: there is no account, no history, and no return visit to resume.
Relevant inputs or decisions. The viewer's only input is choosing to open the slide and, optionally, activating "Read the slide" to bring the facts into view. They decide when they have read enough and leave.
Interactions with other accepted participants. None. There is no author, editor, or other viewer interaction in the accepted product. The only counterpart is the rendering runtime that draws the atom and the backend that serves the facts, neither of which the viewer addresses directly.
Observable success. The viewer has seen the headline, the subline, the live atom, and all three fact rows, fully legible, on their viewport — and can state what the nucleus, the shells, and the electrons are.
Failure and recovery. If the facts fail to load, the headline, subline, and live atom remain, and an inline message with a retry control appears in the fact-row area. The viewer activates retry, the page re-requests the slide content, and the fact rows render on success. If the real-time renderer is unavailable, the atom is shown as a static composition so the explainer stays complete.
Reduced motion. With prefers-reduced-motion, the atom is drawn as a static arrangement and the orbit and light sweep do not animate; all text and controls remain fully readable and the flow completes identically.
The visual direction is Data made physical for one atom slide, after the muse Refik Anadol: a luminous field of data turned into a calm, museum-grade frame.
Mode. Dark mode only.
Color tokens (exact hex, by role)
#07090C — near-black, holds roughly 80% of the frame.#101720 — used sparingly for the fact-row area and any inline notice.#F2F6F8 — headline, subline, fact values, labels.#5FE3C0 — cyan-mint; electron paths and rings.#FF7A45 — orange; the nucleus and key numbers only.#8A99A6 — secondary labels and dividers.Typography
clamp(...) so it stays whole at 375px, 768px, and 1280px.Shape language. Soft radial rings and thin luminous strokes. The nucleus is a tight cluster of small spheres. No hard cards.
Layout. One full-viewport slide. The generative atom sits center-right and fills the right two thirds. A left column carries the headline and three short fact rows with hairlines.
Spacing rhythm. Generous, museum-like margins; hairline rules separate fact rows; the left column is flush left with a consistent vertical rhythm between label, headline, subline, and rows.
Imagery style. A generative particle field forms the atom; fine dust particles drift on the dark ground. No stock photography.
Motion. Slow continuous orbit of electrons; a soft light sweep crosses the rings every eight seconds. No scroll-linked morph — the slide is one frame.
Avoid. No gradient blob behind centered text; no blue or indigo accent; no grid of identical cards; no stock photography of people; no bouncy or playful motion. The generic indigo/blue-on-white SaaS template is forbidden.
The public entry is a single full-bleed near-black canvas. A large glowing atom — mint rings and electron paths around an orange nucleus — fills the right two thirds of the first screen, with fine dust drifting across the dark ground. The left third holds the headline flush left over a hairline rule, with a 12px uppercase label above it, the subline beneath, and three fact rows below that, each pairing a number in Space Grotesk with a small uppercase label and a thin divider.
The signature moves, recomposed only from accepted content and controls:
The entry hero copy is the accepted copy: headline "One atom, one slide", subline "See the nucleus, the shells and the electrons that make all matter.", call to action "Read the slide". The call to action brings the fact rows into view within the same frame; it does not open a second page.
Interaction Model: Animated Motion Tempo: cinematic Hero Dimensionality: webgl
Landing Hero Motion Brief
prefers-reduced-motion, the atom is drawn as a static composition — nucleus, rings, and dust held still — and the orbit and light sweep do not animate. All text and controls remain fully readable and the slide is complete.Landing Hero 3D Scene Brief — DIRECTION-DERIVED
A single real-time WebGL scene (React Three Fiber) renders the atom as the hero subject: a tight cluster of small spheres for the orange nucleus, thin luminous mint rings for the shells, and small mint particles traveling the rings as electrons. A particle field of fine dust drifts across the dark ground. The scene is lit to keep the near-black ground dominant, with the mint glow marking the electron paths and the orange reserved for the nucleus and key numbers. The scene runs a slow continuous orbit and an eight-second light sweep, and renders a static composition under reduced motion.
none)font-size: clamp(...)) to fit; no other element covers any part of them. (explicit)prefers-reduced-motion, the slide provides a usable static arrangement with all text and controls readable. (explicit)frontend, backend, and database. No Kubernetes is required for this single-slide product.none)prefers-reduced-motion state in which the atom is drawn as a static composition.
No comments yet. Be the first!