Skip to content

docs: restyle landing page with hero CTAs, install bar and generator carousel#604

Merged
cogwirrel merged 3 commits intomainfrom
docs/landing-makeover
Apr 21, 2026
Merged

docs: restyle landing page with hero CTAs, install bar and generator carousel#604
cogwirrel merged 3 commits intomainfrom
docs/landing-makeover

Conversation

@nx-plugin-for-aws
Copy link
Copy Markdown
Collaborator

Reason for this change

The previous landing page didn't convey what the plugin does at a glance. It lacked a focused hero, a one-click install command, and any showcase of what generators can scaffold. Strands-Agents' docs served as the design reference — a clear hero with Get started + secondary CTA, a copy-paste install bar, and a terminal that shows real code.

Description of changes

  • Hero: splash template with primary Get started and secondary Build with AI buttons, tightened tagline and image sizing.
  • Install bar (copy-command.astro): rounded pill with prompt indicator and one-click clipboard copy (check-mark confirms). Drops pnpm create @aws/nx-workspace on the landing page so users can get moving in one copy.
  • Generator carousel (generator-carousel.astro): macOS-style terminal that auto-rotates every 6s (pauses on hover, clickable pills) through four scenarios: Multi-Agent AI, tRPC Web App with CDK, FastAPI Web App with Terraform, AG-UI Web App. Uses Starlight's <Code> component for syntax highlighting, with generator IDs marked. No --flags — users are prompted for values when they run them.
  • Cards: four value-prop cards (Full-stack in minutes, Build with AI, Type-safe end to end, Your code, your way).
  • Brand accent: a single --brand-* palette block in custom.css drives --sl-color-accent, so the palette can be swapped in one place. Currently set to a royal neon purple; AWS orange, Nx blue, teal, amber+slate all work as drop-in alternatives.
  • Typography: mono font applied to site title and hero heading for a dev-tooling feel.

Description of how you validated changes

  • pnpm nx run docs:build — 809 pages built, Starlight links validator passes.
  • Visually verified the landing page renders: hero CTAs, install bar copy-to-clipboard, carousel auto-rotation and pill navigation, card grid, community and contributors sections.

Issue # (if applicable)

N/A

Checklist


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

nx-plugin-for-aws and others added 3 commits April 21, 2026 13:08
…carousel

Refresh the docs landing page with a strands-inspired layout: a focused
hero with Get started and GitHub buttons, a one-click copy install
command, and an auto-rotating terminal carousel showcasing common
generator combinations (website+api+infra+connection, strands agent+mcp,
FastAPI, serverless). Introduce a configurable AWS-orange accent via
a single set of --brand-* variables so the palette can be swapped
trivially.
- Swap brand accent to royal neon purple
- Use mono font for site title and hero heading
- Replace carousel examples: Multi-Agent AI, tRPC with CDK, FastAPI
  with Terraform, AG-UI Web App
- Add Cognito auth to all website examples
- Highlight generator IDs in code blocks
- Use Starlight Code component instead of raw pre/code
- Fix copy-command check icon centering (Tailwind v4 svg reset)
- Fix pill button height consistency
- Update hero buttons: Get Started + Build with AI
- Add fourth "Your code, your way" card
- Remove my-project from create workspace command
@github-actions
Copy link
Copy Markdown
Contributor

📚 Documentation translations have been updated and committed (cab7eab) to this PR.

docs/src/content/docs/es/index.mdx
docs/src/content/docs/fr/index.mdx
docs/src/content/docs/it/index.mdx
docs/src/content/docs/jp/index.mdx
docs/src/content/docs/ko/index.mdx
docs/src/content/docs/pt/index.mdx
docs/src/content/docs/vi/index.mdx
docs/src/content/docs/zh/index.mdx

@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.02%. Comparing base (00935a5) to head (cab7eab).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #604   +/-   ##
=======================================
  Coverage   89.02%   89.02%           
=======================================
  Files         106      106           
  Lines        3443     3443           
  Branches      747      747           
=======================================
  Hits         3065     3065           
  Misses        174      174           
  Partials      204      204           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@cogwirrel cogwirrel merged commit ab95675 into main Apr 21, 2026
19 checks passed
@cogwirrel cogwirrel deleted the docs/landing-makeover branch April 21, 2026 03:50
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.

3 participants