Skip to content

refactor(frontend): retire frontend-static-site; keep its general rules (#2086) - #2103

Merged
braboj merged 4 commits into
mainfrom
refactor/retire-static-site
Oct 21, 2026
Merged

braboj merged 4 commits into
mainfrom
refactor/retire-static-site

Conversation

@braboj

@braboj braboj commented Oct 21, 2026 •

Copy link
Copy Markdown
Collaborator

Retires frontend-static-site. Its CSS, font and theme choices fit one site's stack, not every static site.

Rules Destination
One global stylesheet, BEM naming, no CSS-in-JS removed; frontend-quality CSS already covers tokens, inline styles, a naming convention
System fonts, self-hosted woff2, font-display: block removed; frontend-content Assets already serves nothing from outside the build
The localStorage theme snippet removed; the rule stays as static-site-theme in frontend-quality: the theme applies before first paint, server-rendered or by a blocking <head> script where the browser stores it (MUST / MUST NOT kept)
Trailing-slash hosting check (MUST, SHOULD) static-site-trailing-slash in frontend-content, ID kept
Page table (homepage, 404) a custom 404 page in frontend-content SEO
Static output, zero-JS default frontend-quality Performance: render at build or on the server by default
Lint and format files; preload and defer already in frontend-quality
  • IDs removed with the template: frontend-static-site, static-site-stack, -architecture, -pages, -code, -typography; none is referenced elsewhere
  • frontend-content's lead-in now says a stack extends it
  • Manifest entry and baseline row removed; generated block re-synced
  • SHOULD and MAY count carried over: the trailing-slash SHOULD moves intact
  • Migration-guide rows added; a Breaking changes line follows
  • Fork side: Imbra-Ltd/imbra-ai-templates#60
Score Before After
frontend-content 87.6 90.7
frontend-quality 93.6 93.5, re-recorded: the added words are the server-rendering qualifier a review asked for
frontend-static-site 84.2 removed

Checks

  • Smoke 35/35; conformance 12 passed, 0 failed, 1 not applicable; readings read
  • Fork sync, redundancy audit, resolve, sync_docs --check, score ratchet
  • markdownlint, pre-commit hooks

Closes #2086.

🤖 Generated with Claude Code

braboj and others added 4 commits October 21, 2026 17:07
…es (#2086)

One stylesheet, BEM naming, system fonts, the theme snippet and the page
table are one site's choices and leave with the template. The theme
flash rule and the trailing-slash check move to frontend-quality and
frontend-content with their IDs; a custom 404 page and build-time
rendering by default join them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The rule mandated a blocking head script, but a server-rendered page
that emits the stored theme avoids the flash without one. The script
is now required only where the browser stores the theme. The score
row drops from 94.2 to 93.5 for the added qualifier.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…c-site

# Conflicts:
#	CHANGELOG.md
#	docs/architecture/05-building-block-view.md
#	docs/migrating-to-v3.md
@braboj
braboj merged commit 8c32fba into main Oct 21, 2026
14 checks passed
@braboj
braboj deleted the refactor/retire-static-site branch October 21, 2026 19:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Move the static-site implementation preset to Imbra

1 participant