feat(website): custom landing with Hero, Mermaid workflow, features (PR3)#165
Merged
Conversation
…PR3)
Third and last planned PR for the website rollout. Replaces the PR1
placeholder landing with a full home composed from four sections:
- Hero (src/components/Hero/) — H1 tagline ("Cognitive discipline for
AI-assisted engineering"), three pillars (Track every decision · Detect
drift empirically · Audit-ready by default), and a dual CTA: the install
oneliner as a copyable CodeBlock + buttons to /docs and /blog.
- WorkflowDiagram (src/components/WorkflowDiagram/) — Mermaid flowchart
of the Human ↔ Agent ↔ StrayMark loop (Spec → Charter → Plan → AILOG →
Self-audit → TDE → Review → Audit trail). Enables
@docusaurus/theme-mermaid and `markdown.mermaid: true`.
- WhyExists (src/components/WhyExists/) — one-paragraph positioning lead
sourced from Aparador/Categorización/Posicionamiento-completo §3.
- FeatureGrid (src/components/FeatureGrid/) — 6 cards linking to docs:
cognitive discipline, repo-native, agent governance, evidence as
byproduct, CLI, TDE drift detection.
All copy is wrapped in <Translate> with i18n keys; full Spanish translation
ships in website/i18n/es/code.json so the locale switcher gives a fully
translated landing on /es/.
CSS modules per component with system-color-aware tokens (uses Docusaurus
CSS variables) so it works in light and dark mode.
Out of scope (deferred to follow-ups):
- Asciinema demo cast (no recording yet; placeholder skipped intentionally
rather than shipping a fake)
- Footer badges (build / release / CLA) — needs real URLs and decisions
- Lighthouse pass against the live site (test after deploy)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Third and final planned PR for the website rollout. Replaces the PR1 placeholder landing with a full home composed from four sections, fully translated to Spanish.
src/components/Hero/CodeBlock) + buttons to/docsand/blogsrc/components/WorkflowDiagram/src/components/WhyExists/Aparador/Categorización/Posicionamiento-completo §3src/components/FeatureGrid/Mermaid
Enables
@docusaurus/theme-mermaidandmarkdown.mermaid: true. The home workflow is rendered via<Mermaid value={...}>; future MDX pages can use fencedmermaidblocks for free.i18n
All user-facing copy is wrapped in
<Translate>/translate()with stable IDs; full Spanish translation ships inwebsite/i18n/es/code.json. The locale switcher on/lands you on a fully Spanish home at/es/.Styling
CSS modules per component using Docusaurus CSS variables (
--ifm-*), so the landing adapts to light and dark mode without extra logic.Out of scope (deferred follow-ups)
Test plan
cd website && npm installnpm run start→/shows Hero + Mermaid diagram (light/dark mode renders both) + Why + 6 feature cards/docsand/blog/es/shows the full Spanish landing (pillars, captions, features, why-paragraph all translated)npm run buildexits 0 with no new warnings beyond the pre-existing PR1 setDeploy WebsiteAction runs green and the live landing is up athttps://strangedaystech.github.io/straymark/🤖 Generated with Claude Code