Skip to content

fix(homepage): broken links and white navbar on dark homepage#8334

Draft
Copilot wants to merge 6 commits intomainfrom
copilot/restyle-docs-and-rework-start
Draft

fix(homepage): broken links and white navbar on dark homepage#8334
Copilot wants to merge 6 commits intomainfrom
copilot/restyle-docs-and-rework-start

Conversation

Copy link
Contributor

Copilot AI commented Mar 19, 2026

Description

Fixes two issues with the homepage PoC:

1. Build failure — broken links

Five self-managed/setup/deploy/... paths don't exist. Updated to current doc structure:

Broken Correct
setup/deploy/local/c8run/ quickstart/developer-quickstart/c8run/
setup/deploy/local/docker-compose/ quickstart/developer-quickstart/docker-compose/
setup/deploy/kubernetes/ reference-architecture/kubernetes/
setup/deploy/amazon/amazon-eks/ deployment/helm/cloud-providers/amazon/amazon-eks/amazon-eks/
setup/deploy/gcp/ deployment/helm/cloud-providers/gcp/google-gke/

2. White navbar on dark homepage

The homepage-dark-override CSS class was defined but never applied. Fixed with:

  • wrapperClassName="homepage-dark-wrapper" on the Layout component
  • html:has(.homepage-dark-wrapper) CSS selectors to style navbar/footer/announcement-bar dark — works on first paint, no flash
  • useEffect adds class to <html> as secondary mechanism; removes on unmount so docs pages are unaffected
/* Only matches when homepage wrapper is present in the DOM */
html:has(.homepage-dark-wrapper) .navbar {
  background: #0a0a0f !important;
  border-bottom: 1px solid #222;
}

homepage-dark-navbar

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
  • This is already available but undocumented and should be released within a week. (add available & undocumented label)
  • This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
  • This is part of a scheduled alpha or minor. (add alpha or minor label)
  • There is no urgency with this change (add low prio label)

PR Checklist

  • The commit history of this PR is cleaned up, using {type}(scope): {description} commit message(s)

  • My changes are for an upcoming minor release and are in the /docs directory (version 8.9).

  • My changes are for an already released minor and are in a /versioned_docs directory.

  • I added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • www-api.ibm.com
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/camunda-docs/camunda-docs/node_modules/@ibm/telemetry-js/dist/REDACTED-process.js --log=/tmp/ibmtelemetry-20260319T202911073Z-572383.log --config=telemetry.yml (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.

Copilot AI and others added 2 commits March 19, 2026 20:00
- Complete new hero section: "Start building with Camunda"
- Two-card SaaS vs CLI start options with feature checklists and CTAs
- Quick install section with c8ctl terminal demo
- More ways to run Camunda (Docker Compose, Kubernetes)
- Production deployment options (AWS EKS, GCP GKE, Kubernetes+Helm)
- Architecture at a glance diagram linking to component docs
- Everything from your terminal section with c8ctl commands
- Teach your AI Agent Camunda section with MCP config
- Explore the docs grid preserving existing navigation
- Global CSS overrides scoped to homepage dark page

Co-authored-by: MaxTru <42800119+MaxTru@users.noreply.github.com>
…duce c8ctl

- Replace IBM Plex Mono with system monospace fallback (Fira Code, ui-monospace)
- Extract monospace font into --mono-font CSS variable
- Restore white-space: pre-wrap on terminal pre blocks
- Add c8ctl introduction in CLI card description

Co-authored-by: MaxTru <42800119+MaxTru@users.noreply.github.com>
Copilot AI changed the title [WIP] Restyle documentation for modern dark layout and improve getting started experience PoC: Dark-themed homepage redesign focused on getting-started experience Mar 19, 2026
Copilot AI requested a review from MaxTru March 19, 2026 20:05
@MaxTru MaxTru added the deploy Stand up a temporary docs site with this PR label Mar 19, 2026
Fix 5 broken doc paths causing build failure:
- c8run -> self-managed/quickstart/developer-quickstart/c8run
- docker-compose -> self-managed/quickstart/developer-quickstart/docker-compose
- kubernetes -> self-managed/reference-architecture/kubernetes
- amazon-eks -> deployment/helm/cloud-providers/amazon/amazon-eks/amazon-eks
- gcp -> deployment/helm/cloud-providers/gcp/google-gke
- Helm install -> deployment/helm/install/quick-install

Fix white navbar on dark homepage:
- Add wrapperClassName="homepage-dark-wrapper" to Layout
- Add html:has(.homepage-dark-wrapper) CSS selectors for navbar, footer, announcement bar
- Add useEffect to set homepage-dark-override class on html element
- Dark styling only applies when homepage wrapper is present

Co-authored-by: MaxTru <42800119+MaxTru@users.noreply.github.com>
Copilot AI changed the title PoC: Dark-themed homepage redesign focused on getting-started experience fix(homepage): broken links and white navbar on dark homepage Mar 19, 2026
@github-actions github-actions bot temporarily deployed to camunda-docs March 19, 2026 21:15 Destroyed
@github-actions
Copy link
Contributor

The preview environment relating to the commit 05186d8 has successfully been deployed. You can access it at https://preview.docs.camunda.cloud/pr-8334/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deploy Stand up a temporary docs site with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants