amare/openspec/changes/build-public-site/specs/content-media/spec.md at 27f3cee855f0d432bdc3c9b6a179a46c19195cf1

Files

manoel freitas 27f3cee855 feat: ship public site with SEO and visuals

Publish CMS content on public routes with responsive media,
accessibility checks, and deterministic visual baselines.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-29 08:36:59 -03:00

2.4 KiB

Raw Blame History

ADDED Requirements

Requirement: Public images are served in responsive variants

The system SHALL generate or serve responsive variants for public content images (service covers, portfolio covers and gallery, testimonial photos) and reference them with srcset and sizes so browsers download an appropriately sized file (SPEC §6.4). Variant generation MUST happen on upload, not on each request.

Scenario: Variants are produced on upload

WHEN an admin uploads a public content image
THEN responsive variants MUST be generated and stored alongside the original
AND the database MUST keep only paths, never binary data

Scenario: Public markup offers multiple sources

WHEN a public page renders a content image
THEN the img element MUST expose srcset with the available variants
AND MUST expose a sizes attribute matching the layout

Scenario: Missing variant falls back to the original

GIVEN an image stored before variant generation existed
WHEN it is rendered on a public page
THEN the original file MUST be used without breaking the page

Requirement: Public images avoid layout shift and defer offscreen loading

Public content images SHALL reserve their space through explicit width and height (or equivalent aspect-ratio styling) and MUST use loading="lazy" when rendered below the fold. Above-the-fold hero imagery MUST NOT be lazy loaded (SPEC §6.4, §6.6).

Scenario: Offscreen image is lazy loaded

WHEN a page renders an image below the first viewport
THEN the img element MUST carry loading="lazy"

Scenario: Hero image loads eagerly

WHEN the home hero image is rendered
THEN it MUST NOT carry loading="lazy"

Scenario: Dimensions are reserved

WHEN any public content image is rendered
THEN width and height (or aspect ratio) MUST be declared so layout does not shift after load

Requirement: Production images are not served from ephemeral container disk

Public image variants SHALL be stored on the configured filesystem disk (S3-compatible in production) and referenced by URL, so a container restart or redeploy does not lose media (SPEC §6.4).

Scenario: Media survives container replacement

GIVEN production uses the S3-compatible disk
WHEN the application container is replaced
THEN previously uploaded images and variants MUST remain reachable

2.4 KiB Raw Blame History