Velvet Bean is a neighbourhood specialty coffee shop with a premium, cozy register. This project delivers its public website: a unique, aesthetic, exactly three-page experience — Home, Menu, and Contact — that presents the brand, the popular coffee items, and the opening hours to prospective customers.
The product intent is sensory and brand-led rather than transactional. The site must feel made by hand: warm colors, elegant typography, high-quality art-directed imagery, and a beautifully animated surface with smooth page transitions, scroll animations, elegant hover effects, and subtle animated background elements. It must be fully responsive across mobile, tablet, and desktop, and it must not add complex functionality — no ordering, accounts, payments, reservations, or backend workflows. The audience is the everyday ritual drinker and the weekend lingerer who wants craft, warmth, and personality rather than a corporate chain's sterility.
Velvet Bean is a static-presentation, three-page marketing website. All three pages are publicly reachable with no access requirement: a visitor lands on Home, browses Menu for popular coffee items, and visits Contact for contact details and opening hours. Navigation between the three pages is animated with a terracotta page-transition wipe.
The only accepted human actor is the Coffee Shop Visitor. There is no application-owned identity, no sign-in, no session continuity, and no differentiated permissions — the site is fully public and stateless from the visitor's perspective. There are no provider-owned or external destinations; every accepted behavior is owned by one of the three first-party pages.
Current delivery is a responsive, animated, image-led front-end. Explicitly out of scope: any complex functionality (ordering, cart, checkout, payments, reservations, table booking, user accounts, reviews, live chat, newsletter signup workflows, or admin tooling).
The website is a public, no-account brand surface. Every page is anonymously reachable; nothing on the site requires a visitor to identify themselves, and no visitor-specific state is stored or resumed. Because no accepted behavior creates a durable relationship, obligation, entitlement, or value transfer, no identity establishment or verification lifecycle is required, and none is added.
The delivery boundary is deliberately narrow. The site presents the brand, the popular coffee items, and the opening hours, and it lets a visitor move between the three pages with rich, purposeful motion. Everything beyond presentation and navigation — ordering, payment, booking, accounts, messaging, and any server-side workflow — sits outside the current horizon and is not built. Contact details are presented for the visitor to use through their own channels; the site itself does not transmit, store, or process any visitor submission.
Not applicable. No reference directive in this project declares a content_source, so no verified external content inventory is carried into this document. All product facts (brand name, page set, popular coffee items, opening hours, contact details) are supplied by the authoritative user requirement thread and the creative direction.
The page inventory is the closed, ordered contract: Home, Menu, Contact. Each is represented exactly once below.
clamp(64px, 12vw, 148px), second line italic and indented two columns, overhanging the photograph's right edge by exactly two columns on desktop and sitting fully inside the viewport above the photo on mobile; full-width 2px terracotta rule beneath the headline.FR-1 — Three-page site structure (explicit) As a Coffee Shop Visitor, I should be able to reach exactly three pages — Home, Menu, and Contact — so that I can explore the whole site without encountering any other destination.
FR-2 — Premium, cozy brand presentation (explicit) As a Coffee Shop Visitor, I should see a unique and aesthetic presentation with a premium, cozy coffee-shop feel so that Velvet Bean reads as a crafted neighbourhood café rather than a generic template.
FR-3 — Popular coffee items on the Menu page (explicit) As a Coffee Shop Visitor, I should be able to browse Velvet Bean's popular coffee items on the Menu page so that I can learn what the shop serves.
FR-4 — Opening hours on the Contact page (explicit) As a Coffee Shop Visitor, I should be able to view Velvet Bean's opening hours on the Contact page so that I know when the shop is open.
FR-5 — Contact details on the Contact page (explicit) As a Coffee Shop Visitor, I should be able to view Velvet Bean's contact details on the Contact page so that I can reach the shop through my own channels.
FR-6 — Smooth page transitions (explicit) As a Coffee Shop Visitor, I should experience a smooth animated transition when moving between Home, Menu, and Contact so that navigation feels crafted rather than abrupt.
FR-7 — Scroll animations (explicit) As a Coffee Shop Visitor, I should see content animate into view as I scroll so that the page feels alive and paced.
FR-8 — Elegant hover effects (explicit) As a Coffee Shop Visitor, I should see elegant hover effects on interactive elements so that the site responds with tactile, hand-made character.
FR-9 — Subtle animated background elements (explicit) As a Coffee Shop Visitor, I should see subtle animated background elements so that the site has quiet, continuous atmosphere.
FR-10 — Fully responsive layout (explicit) As a Coffee Shop Visitor, I should be able to read and use the whole site on mobile, tablet, and desktop so that nothing is cut off or unreadable at any viewport.
font-size: clamp(...) with its mobile size) to fit; the Menu ledger collapses to one column below 768px; the Home hero headline sits fully inside the viewport above the photo on mobile.FR-11 — No complex functionality (explicit) As a Coffee Shop Visitor, I should encounter a simple, presentation-only site so that nothing distracts from the brand and the coffee.
Product context. The Coffee Shop Visitor is a prospective customer of Velvet Bean — the everyday ritual drinker or the weekend lingerer. They arrive at the site with a sensory, low-commitment intent: they want to feel the shop's character, see what it serves, and find out when it is open and where it is. They are not shopping online and are not looking for an account, an order, or a booking.
Primary goal. To quickly learn what Velvet Bean serves and when it is open, while enjoying a premium, cozy, hand-made-feeling brand experience.
Distinct accepted responsibilities. This is the only accepted human actor, and their work is entirely exploratory and read-only:
Relevant inputs or decisions. The visitor decides whether the shop's offerings and hours match what they want, and whether to visit in person. Their inputs are simply navigation choices and scrolling; they make no commitment, submit no data, and create no account.
Interactions with other accepted participants. There are no other accepted human participants. The visitor's only counterparty is the shop itself, represented by the site's content. There is no handoff, no counterparty response, and no shared state.
Observable success. The visitor can state what Velvet Bean serves, when it is open, and where it is, having moved through all three pages without encountering any broken layout, unreadable text, or unexpected functionality.
Constraints carried from source. The visitor's experience must be fully responsive, richly but purposefully animated, and free of complex functionality. No access requirement applies to any page.
prefers-reduced-motion on their device and opens the site on Home.The creative direction is authoritative for this section. The muse is Stefan Sagmeister, and the headline concept is "Handmade warmth, poured bold — Velvet Bean as tactile typographic art." Type is built from real materials, imperfection is on purpose, and wit has an edge — the language of a coffee shop that roasts its own beans and pours latte art by hand.
Dark mode (the only mode — the entire site sits on the espresso dark):
| Role | Token | Hex | Usage |
|---|---|---|---|
| Background | Espresso dark ground | #1B120C | Carries 60% of the surface |
| Surface | Roasted surface | #2A1C13 | Cards and panels, always with a 1px #3A2A1E hairline |
| Text | Crema cream | #F4E9DC | The only body/heading text colour; ~13:1 contrast on the ground |
| Primary | Roasted terracotta | #C4552B | Buttons, dividers, hover states — never as a large field |
| Accent | Honey amber | #E8B44A | Steam mark, "open now" dot, price numerals, link underline |
| Muted | Muted walnut | #9A7B62 | Secondary metadata, timestamps, captions |
| Hairline | Surface border | #3A2A1E | 1px border on every surface |
No white anywhere. No blue, indigo, or violet accent. No gradient-blob heroes, glassmorphism, or frosted-glass surfaces.
SOFT=100, WONK=1 for display — a slightly wonky, hand-cut serif that reads as letterpress. Headlines are set tight (tracking -0.02em, leading 0.92) and often in two stacked lines, with the second line indented or set in italic to break the grid on purpose.1.7 leading, never wider than 62ch.64px mobile → 148px desktop (clamp); h2 40px → 72px; h3 24px → 32px; body 16px → 18px; label 12px → 13px uppercase with 0.18em tracking.system-ui anywhere. Fraunces and Work Sans only.Hard edges everywhere — no border-radius above 2px except on the cup-rim circle motif. Rules are 2px solid terracotta and run full-bleed. Stamps and badges are square with 3px offset outlines. The only curves in the system are the circle (cup rim, steam mark, open/closed dot) and the hand-drawn underline swash that appears under nav items on hover.
A 12-column grid with a deliberately broken rhythm. The Home hero is a full-bleed photograph with a stacked Fraunces headline that overhangs the photo's right edge by 2 columns on desktop and sits entirely inside the viewport at 375px. Menu is a two-column ruled list (name + dotted leader + price) that collapses to one column below 768px, with a large Fraunces category numeral (01, 02, 03) in the left margin. Contact is a three-band stack: a big address block, a ruled opening-hours table with the current day highlighted in amber, and a photographic map-card. Every section is separated by a full-bleed 2px terracotta rule, never by whitespace alone.
Art-directed photography with real texture: macro shots of crema and latte art, hands cupping a warm mug, a burlap sack of green beans, the espresso machine's brass group head. Photos are treated with a warm duotone (espresso shadows, crema highlights) so they sit inside the palette rather than fight it. Where photography would be too literal, use photographed handmade typography — beans spelling a word, a latte-art swirl forming the 'V' of Velvet. No stock photography of people at laptops or generic café interiors.
The public entry — Home — is built as a single photographic poster band with an overhanging headline, and it is the site's defining gesture.
The composition. A full-bleed, low-lit photograph of a single cup being poured, shot from slightly above so the crema swirl fills the lower-right third. Over it, a 9-column Fraunces headline "SLOW / MORNINGS" in crema cream at clamp(64px, 12vw, 148px). The second line is indented two columns and set in italic. On desktop the two lines overhang the photograph's right edge by exactly two columns; on mobile the headline sits fully inside the viewport above the photo. A terracotta 2px rule runs the full width beneath the headline.
The anchors. Bottom-left: a small uppercase Work Sans label "VELVET BEAN · EST. 2019" with a 6px amber dot. Bottom-right: a circular "OPEN UNTIL 8" badge with a hand-drawn terracotta ring and an amber dot that pulses slowly (2.4s) when the shop is open.
The depth. The whole hero is layered_2d — the photograph drifts 20px on scroll, the headline stays put, the badge parallaxes at 0.5x.
The signature moves carried through the site. Menu rows as a ruled ledger with a hand-drawn terracotta dotted leader that draws itself on hover and prices in Fraunces 900 amber numerals. A 420ms terracotta page-transition wipe that sweeps bottom-left to top-right between Home, Menu, and Contact, with the Velvet Bean wordmark briefly inverted to crema as the wipe passes over it. Full-bleed 2px terracotta rules separating every section instead of whitespace, turning each page into a set of stacked poster bands rather than a scrolling column.
Readability guarantee. Headlines, wordmarks, labels, numbers, item images, cards, and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling to fit. Crops, bleeds, and off-edge placement are reserved for decoration only — shapes, textures, rules, and background art. The hero headline's overhang is carried by the decorative rule and photograph bleed, never by running readable text off an edge.
Interaction Model: Animated Motion Tempo: expressive Hero Dimensionality: layered_2d
NFR-1 — Responsive across viewports (explicit)
The site must be fully responsive at 375px, 768px, and 1280px. Headlines, wordmarks, labels, numbers, item images, cards, and controls stay entirely inside the viewport and their container, wrapping or scaling (for example font-size: clamp(...) with its mobile size) to fit, and no other element covers any part of them. The Menu ledger collapses to one column below 768px. Rationale: explicit user requirement that the website be fully responsive.
NFR-2 — Readable text and needed content stay whole (explicit, from creative direction)
Crops, bleeds, and off-edge placement are for decoration only — shapes, textures, rules, and background art. The one exception is moving content (marquees, tickers, carousels, horizontally scrollable rows), which may cross the viewport or container edge by design and is judged by whether it actually moves and whether every item becomes fully readable as it passes. With prefers-reduced-motion, moving content stops and shows whole items, wrapping into rows or sitting in a horizontally scrollable row (overflow-x: auto). Rationale: the creative direction's readability rule takes precedence over any crop or bleed gesture.
NFR-3 — Reduced-motion support (explicit, from creative direction)
All motion must respect prefers-reduced-motion: wipes become instant cuts, reveals become static, blobs freeze, and hover effects resolve instantly. Rationale: accessibility and the creative direction's stated motion contract.
NFR-4 — Color contrast (explicit, from creative direction)
Crema cream (#F4E9DC) is the only body/heading text colour and sits at approximately 13:1 contrast on the espresso-dark ground (#1B120C). Rationale: the creative direction specifies this contrast ratio as a hard property of the palette.
NFR-5 — No complex functionality (explicit) The site must not add complex functionality. No ordering, cart, checkout, payments, reservations, table booking, user accounts, reviews, live chat, newsletter signup workflows, or admin tooling. Rationale: explicit user constraint.
NFR-6 — Performance of imagery and motion (required_inference) High-quality art-directed imagery and continuous background animation must not block first render: text, rules, and layout render immediately while images load progressively, and the animated background layer sits behind content without intercepting interaction. Rationale: causally necessary so that the accepted premium imagery and animated background requirements do not make the pages unusable while assets load.
NFR-7 — Static, stateless delivery (required_inference) The site stores no visitor-specific state and requires no session continuity; every page is anonymously reachable and no visitor data is collected, transmitted, or persisted. Rationale: causally necessary given that no accepted behavior creates a durable relationship, obligation, entitlement, or value transfer, and no access requirement applies to any page.
clamp() for the type scale, and keyframe animations for the background blobs, grain overlay, and hover effects. [Default — not specified by user]SOFT=100, WONK=1 at 900 weight) and Work Sans (body, 400/500), self-hosted or loaded via a font service. Source-specified by the creative direction.docker-compose for a reproducible local and deployment build. [Default — not specified by user]Kubernetes is not required: the delivery is a static, three-page presentation site with no orchestration needs.
Constraints (binding):
system-ui; no bouncy spring easing; no centred headline + subtext + button hero compositions. (explicit, from creative direction)Assumptions (narrow and labeled):
prefers-reduced-motion — the user's device-level motion preference; when set, wipes become instant cuts, reveals become static, blobs freeze, and hover effects resolve instantly.
Poured by hand since 2019
Velvet Bean roasts in small batches on a drum machine set against the back wall, so the whole room carries the smell of the beans before the first cup is poured. Espresso lands in a warm terracotta cup; the milk drinks get a slow, hand-poured finish at the bar.
The room itself is built for staying: low amber light, hard wooden edges, a few seats at the window and a long shared table. Come for the espresso, stay for the second one.

Poured by hand since 2019
Velvet Bean roasts in small batches on a drum machine set against the back wall, so the whole room carries the smell of the beans before the first cup is poured. Espresso lands in a warm terracotta cup; the milk drinks get a slow, hand-poured finish at the bar.
The room itself is built for staying: low amber light, hard wooden edges, a few seats at the window and a long shared table. Come for the espresso, stay for the second one.
No comments yet. Be the first!