Skip to content

feat(website): streamline homepage and integrate SDK showcase into HowItWorks - #301

Merged
macalbert merged 9 commits into
mainfrom
feat/website-governance-section
Jun 3, 2026
Merged

feat(website): streamline homepage and integrate SDK showcase into HowItWorks#301
macalbert merged 9 commits into
mainfrom
feat/website-governance-section

Conversation

@macalbert

@macalbert macalbert commented Jun 3, 2026

Copy link
Copy Markdown
Owner

Summary

Streamlines the homepage by removing redundant sections and integrating
the SDK showcase directly into the HowItWorks Step 3. Adds governance
positioning as a subtitle in FeaturesGrid and promotes secret rotation
to a highlight card.

Changes

  • FeaturesGrid: subtitle repositioned as governance/positioning frame;
    "Safe Secret Rotation" promoted to highlight Add badge coverage #3; "Secrets Never Touch
    Disk" moved to extras
  • HowItWorks Step 3: enriched with full SDK panels (tab icons, install
    commands, docs links, package links, code examples with fluent builder)
  • Removed sections: Sdks, GitHubAction, Roadmap, GetStarted (content
    was redundant with HowItWorks or belongs in docs)
  • Navbar: removed SDKs and GitHub Action links (sections no longer exist)
  • i18n: updated en/ca/es with new feature structure and removed unused
    translation keys (governance, roadmap, getStarted, gha, beforeAfter)
  • Homepage flow: Hero, TrustBadges, Sponsors, ProblemSolution,
    FeaturesGrid, HowItWorks, DemoVideo, Providers, Footer

Testing

  • astro build passes
  • astro check -- only pre-existing errors in unused components
  • Dev server renders correctly on localhost:4322
  • Biome + commitlint hooks pass

Related

N/A

Summary by CodeRabbit

Release Notes

  • New Features

    • Added dedicated AWS and Azure cloud setup documentation with step-by-step configuration guides.
    • Introduced SDK availability status indicators in the "How it Works" section.
  • Improvements

    • Redesigned features section with two-tier layout highlighting key capabilities and additional features.
    • Enhanced navigation with Changelog link; streamlined navigation menu.
    • Simplified hero section for cleaner landing experience.
  • Documentation

    • Expanded cloud provider setup instructions with credentials, permissions, and verification steps.

Review Change Stack

…wItWorks

- Add governance positioning as FeaturesGrid subtitle (en/ca/es)
- Promote Safe Secret Rotation to highlight card
- Enrich Step 3 with full SDK panels (icons, install, docs, package links)
- Remove standalone Sdks, GitHubAction, Roadmap, GetStarted sections
- Remove SDKs and GitHub Action links from navbar
- Reduce homepage from 13 to 8 sections
Copilot AI review requested due to automatic review settings June 3, 2026 11:02
@coderabbitai

coderabbitai Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Warning

Rate limit exceeded

@macalbert has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 10 minutes and 18 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5176e67e-dc7a-42a0-8159-f11a6e7e7695

📥 Commits

Reviewing files that changed from the base of the PR and between baab89e and 9177429.

⛔ Files ignored due to path filters (1)
  • .editorconfig is excluded by none and included by none
📒 Files selected for processing (9)
  • src/website/src/components/BeforeAfter.astro
  • src/website/src/components/CodeBlock.astro
  • src/website/src/components/DocsContent.astro
  • src/website/src/components/Governance.astro
  • src/website/src/components/HowItWorks.astro
  • src/website/src/i18n/ca.ts
  • src/website/src/i18n/en.ts
  • src/website/src/i18n/es.ts
  • src/website/src/i18n/types.ts

Walkthrough

The PR restructures the website homepage by removing underutilized sections and updating navigation, redesigns the features and how-it-works components with new layouts, simplifies the problem/solution display, and significantly expands documentation structure to include dedicated AWS and Azure cloud setup guides with step-by-step verification flows. The i18n schema is updated to match these structural changes across all supported locales.

Changes

Website Homepage and Documentation Restructuring

Layer / File(s) Summary
Homepage page composition and navigation
src/website/src/pages/index.astro, src/website/src/pages/ca/index.astro, src/website/src/pages/es/index.astro, src/website/src/components/Hero.astro, src/website/src/components/Navbar.astro
All locale homepages remove imports for BeforeAfter, GetStarted, GitHubAction, Roadmap, and Sdks components; rendering order shifts so FeaturesGrid, HowItWorks, DemoVideo, and Providers appear after ProblemSolution. Hero component removes the app version badge. Navbar removes SDKS and GitHub Action links and adds a Changelog link.
Problem/Solution section simplification
src/website/src/components/ProblemSolution.astro
Solutions grid display and arrow divider markup are removed; only the problems grid is rendered. Corresponding CSS rules for .solution-card, .arrow-divider, and .arrow-text are deleted.
Features grid two-tier layout
src/website/src/components/FeaturesGrid.astro
Features display restructures from a single features list to a two-tier layout: a highlights 2x2 grid (tier 1) with conditional coming-soon styling, and an extras section (tier 2) with icon/title/description cards. CSS is rewritten to style highlight-card and new extras-* classes.
SDK documentation tabs custom UI
src/website/src/components/HowItWorks.astro
Replaces TabbedCodeBlock with custom tab/panel UI. SDK tab data is enriched with install commands, package/docs links, and status (available/planned). Planned SDKs (Go, Java) render as disabled tabs. Available SDKs render active tabs with header links and code/install blocks. Client-side script initHiwSdkTabs manages tab activation, panel visibility, and ARIA attributes on astro:page-load.
Documentation page navigation and AWS/Azure setup sections
src/website/src/components/DocsContent.astro
Section order is reorganized to include aws-setup and azure-setup early and move config-priority near CLI content. Mobile and sidebar navigation are updated to reflect new structure. Two new major sections are added: aws-setup (credentials, permissions table, SSM verify with Python) and azure-setup (RBAC vs policy options, permissions, Key Vault verify with Python). Config-priority documentation is relocated earlier in the page.
i18n translation type schema updates
src/website/src/i18n/types.ts
ThemeTranslations removes openSource. ProblemSolutionTranslations removes arrowText. FeaturesTranslations is restructured to replace features array with highlights and extras (new FeatureExtraItem type). DocsTranslations reorganizes sidebar keys and adds explicit awsSetup* and azureSetup* keys for credential, permission, and verification content. BeforeAfterRow and BeforeAfterTranslations interfaces are removed. Translations interface drops beforeAfter property.
i18n translation content for all locales
src/website/src/i18n/en.ts, src/website/src/i18n/es.ts, src/website/src/i18n/ca.ts
All locales remove hero.openSource and problemSolution arrowText/solutions fields. Features section is replaced with new "Why Envilder?" messaging featuring highlights and extras. Docs sidebar labels are updated with AWS/Azure setup entries and adjusted GitHub Action sublabels. Docs content gains expanded step-by-step AWS and Azure setup documentation (credentials, permissions, verification flows, RBAC vs policy options) replacing prior generic credential/permission text. Azure access note is removed.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

  • macalbert/envilder#199: Modifies HowItWorks.astro SDK tabs rendering for Node.js/TypeScript content and tab behavior.
  • macalbert/envilder#295: Adds/removes the BeforeAfter component and corresponding i18n translation types, inverse of this PR's changes.
  • macalbert/envilder#170: Adds Node.js SDK integration with website documentation and i18n updates.

Suggested labels

enhancement

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The PR title clearly and concisely describes the primary change: streamlining the homepage and integrating SDK showcase into HowItWorks, which aligns with the main objectives of the changeset.
Description check ✅ Passed The PR description comprehensively covers all required sections: what the PR does, type of change (feature), detailed changes across components, testing validation, and notes for reviewers.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/website-governance-section

Warning

Review ran into problems

🔥 Problems

Git: Failed to clone repository. Please run the @coderabbitai full review command to re-trigger a full review. If the issue persists, set path_filters to include or exclude specific files.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request restructures and simplifies the website's landing page and documentation. It removes several homepage sections (such as BeforeAfter, Sdks, and Roadmap), reorganizes the documentation to feature dedicated AWS and Azure setup guides, and redesigns the features grid and SDK tabs component with a cleaner layout and tab-switching logic. Feedback on these changes includes a recommendation to refactor the SDK tab initialization script to support multiple instances on a single page, and a request to reorder the GHA HTML sections in the documentation to match the updated sidebar navigation flow.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread src/website/src/components/HowItWorks.astro
Comment thread src/website/src/components/DocsContent.astro

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Streamlines the Astro website homepage flow by removing redundant homepage sections, reshaping the feature presentation, and embedding the SDK showcase directly into the “How it works” flow. This aligns the homepage with a simpler narrative while keeping SDK onboarding details discoverable via Step 3 and docs.

Changes:

  • Simplified homepage composition by removing multiple sections (Before/After, SDKs, GHA, Roadmap, Get Started) and updating localized homepages accordingly.
  • Refactored feature presentation into “highlights” + “extras” (with updated i18n types/strings) and adjusted FeaturesGrid layout.
  • Expanded “HowItWorks” Step 3 into an SDK tabbed showcase (install command, docs link, package link, code examples) and reorganized docs navigation into explicit AWS/Azure setup sections.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
src/website/src/pages/index.astro Removes redundant homepage sections to streamline the landing flow.
src/website/src/pages/es/index.astro Mirrors homepage section removals for Spanish locale page.
src/website/src/pages/ca/index.astro Mirrors homepage section removals for Catalan locale page.
src/website/src/i18n/types.ts Updates translation types to reflect new Features structure and revised Docs sidebar/setup keys; removes unused sections.
src/website/src/i18n/en.ts Updates English translations for new Features structure and Docs AWS/Azure setup content; removes unused keys.
src/website/src/i18n/es.ts Updates Spanish translations for new Features structure and Docs AWS/Azure setup content; removes unused keys.
src/website/src/i18n/ca.ts Updates Catalan translations for new Features structure and Docs AWS/Azure setup content; removes unused keys.
src/website/src/components/ProblemSolution.astro Removes the “solutions”/arrow-divider block to reduce redundancy on the homepage.
src/website/src/components/Navbar.astro Removes navbar anchors for sections that no longer exist on the homepage.
src/website/src/components/HowItWorks.astro Integrates an SDK tabbed showcase into Step 3 (icons, install commands, docs/package links, code examples).
src/website/src/components/Hero.astro Removes version/open-source badge block for a cleaner hero presentation.
src/website/src/components/FeaturesGrid.astro Splits features into “highlights” (2x2) and “extras” list to match new positioning.
src/website/src/components/DocsContent.astro Reorganizes docs navigation/sections into AWS setup + Azure setup and adds verification snippets.

Comment thread src/website/src/components/HowItWorks.astro Outdated
Comment thread src/website/src/components/HowItWorks.astro Outdated
Comment thread src/website/src/components/DocsContent.astro Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/website/src/components/DocsContent.astro`:
- Around line 33-40: The awsVerifyCmd block in the DocsContent.astro example
uses `aws ssm put-parameter` which errors if the parameter already exists;
update the command in the `awsVerifyCmd` string so the SSM put-parameter call is
idempotent by adding the AWS CLI overwrite behavior (use the `--overwrite`
option or wrap with a conditional) so repeated runs succeed; locate and edit the
`awsVerifyCmd` constant to include the overwrite flag for the `aws ssm
put-parameter` invocation.
- Around line 238-239: The list currently shows literal <code>true</code> /
<code>false</code> alongside the localized strings (t.docs.azureRbacTrue /
t.docs.azureRbacFalse), causing duplicated status text; update the
DocsContent.astro template to remove the explicit <code>true</code> and
<code>false</code> markup and render only the localized values (keep the
existing <strong>{t.docs.azureRbacTrue}</strong> and
<strong>{t.docs.azureRbacFalse}</strong> entries), ensuring the false/null case
still maps to t.docs.azureRbacFalse.

In `@src/website/src/components/HowItWorks.astro`:
- Around line 194-205: The tablist lacks keyboard navigation handlers; update
the SDK tab buttons rendered in HowItWorks.astro (look for the sdk-tab-list
container and buttons with id pattern hiw-sdk-tab-{sdk.id} and aria-controls
hiw-sdk-panel-{sdk.id}) to handle keydown events for ArrowLeft, ArrowRight,
Home, and End: implement a shared onKeyDown that finds the index of the current
focused tab in sdkTabs, computes the new target index (wrapping left/right, Home
-> 0, End -> last), preventsDefault, moves focus to the target tab element,
updates aria-selected attributes and tabindex values (selected tab tabindex=0,
others -1), and programmatically activates the tab (e.g., trigger the same
selection logic used on click) so panels and active classes update; attach this
handler to each tab button and ensure it skips tabs with status 'planned'
(aria-disabled).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: cd9b0f8c-5639-419f-82cb-c8409cecb7f7

📥 Commits

Reviewing files that changed from the base of the PR and between 52412c6 and baab89e.

📒 Files selected for processing (13)
  • src/website/src/components/DocsContent.astro
  • src/website/src/components/FeaturesGrid.astro
  • src/website/src/components/Hero.astro
  • src/website/src/components/HowItWorks.astro
  • src/website/src/components/Navbar.astro
  • src/website/src/components/ProblemSolution.astro
  • src/website/src/i18n/ca.ts
  • src/website/src/i18n/en.ts
  • src/website/src/i18n/es.ts
  • src/website/src/i18n/types.ts
  • src/website/src/pages/ca/index.astro
  • src/website/src/pages/es/index.astro
  • src/website/src/pages/index.astro
💤 Files with no reviewable changes (6)
  • src/website/src/components/Navbar.astro
  • src/website/src/pages/index.astro
  • src/website/src/pages/es/index.astro
  • src/website/src/pages/ca/index.astro
  • src/website/src/components/Hero.astro
  • src/website/src/components/ProblemSolution.astro

Comment thread src/website/src/components/DocsContent.astro
Comment thread src/website/src/components/DocsContent.astro Outdated
Comment thread src/website/src/components/HowItWorks.astro
Copilot AI review requested due to automatic review settings June 3, 2026 11:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 1 comment.

Comment thread src/website/src/i18n/types.ts
@macalbert macalbert self-assigned this Jun 3, 2026
@macalbert macalbert added the documentation Improvements or additions to documentation label Jun 3, 2026
Copilot AI review requested due to automatic review settings June 3, 2026 11:19
@macalbert
macalbert merged commit 13226cd into main Jun 3, 2026
7 checks passed
@macalbert
macalbert deleted the feat/website-governance-section branch June 3, 2026 11:23

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 3 comments.

Comment on lines +136 to 142
{
icon: '🧱',
title: 'Zero infraestructura',
description:
'Sense servidors, sense proxies, sense SaaS intermediari. Construït sobre AWS SSM i Azure Key Vault, serveis que ja utilitzes i pagues.',
},
{
Comment on lines 148 to 154
{
icon: '🔌',
title: 'SDKs de runtime',
icon: '🔄',
title: 'Rotació de secrets segura',
description:
"Carrega secrets directament a memòria a l'inici de l'app: Python, .NET, Node.js, Go, Java. Sense fitxers .env a disc. Sense secrets residuals.",
'Rota valors a AWS SSM o Azure Key Vault. Cada consumidor (local, CI/CD i runtime) resol el nou valor automàticament. Sense reescriure .env, sense canvis als pipelines.',
},
{
Comment on lines +12 to +25
<section class="section" id="governance">
<div class="container">
<div class="section-title">
<h2>{t.governance.title}<span>{t.governance.titleAccent}</span></h2>
<p class="section-subtitle">
{t.governance.subtitle}
</p>
</div>

<p class="governance-positioning">{t.governance.positioning}</p>

<div class="grid-3 governance-grid">
{t.governance.benefits.map((b) => (
<div class="pixel-card governance-card">
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants