Skip to content

Conversation

@TechHutTV
Copy link
Collaborator

@TechHutTV TechHutTV commented Jan 13, 2026

Documentation and UI Improvements

Zitadel Integration Documentation Overhaul

Screenshot 2026-01-12 at 7 17 52 PM
  • Rewrote the Zitadel setup guide with a clearer step-by-step flow
  • Added 11 screenshots covering the setup process
  • Updated workflow to match Keycloak/PocketID: get redirect URI from NetBird first, then configure Zitadel
  • Added project creation step
  • Documented required token settings:
    • "Include user's profile info in the ID Token"
    • "User roles inside ID Token" (for group mapping)
  • Updated page title to "Zitadel with NetBird Self-Hosted" for consistency

Self-Hosted Identity Provider Pages

  • Standardized page titles to "X with NetBird Self-Hosted" across:
    • Keycloak
    • Authentik
    • PocketID
    • Zitadel
    • All managed IdP pages (Google, Microsoft, Okta, Auth0, JumpCloud)
    • Advanced/legacy pages

Introduction Page Enhancements

Screenshot 2026-01-12 at 7 18 24 PM
  • Updated CTA buttons:
    • "Try NetBird Cloud" (primary with arrow)
    • "Deploy NetBird Self-Hosted" (new outline-arrow variant, links to quickstart)
  • Reordered Tiles sections (Guides before About NetBird)

Self-Hosted Quickstart Guide Improvements

Screenshot 2026-01-12 at 7 18 58 PM
  • Restructured content flow: Installation Script before Requirements
  • Converted requirements to a table
  • Replaced "Add more users" section with Tiles linking to:
    • Local User Management
    • Identity Providers
  • Added description about Dex and local user management
  • Fixed heading hierarchy and formatting
  • Improved section organization and readability

Component Enhancements

Button Component

  • Added outline-arrow variant:
    • Square corners (rounded-[5px]) like primary
    • Outline styling (ring border, text colors)
    • Supports arrow icons with same layout as primary buttons
  • Updated Header button styling for better height consistency

Tiles Component

  • Added optional description prop to display text between title and tiles
  • Conditional rendering: only shows heading/border when title or description exists
  • Supports JSX in description for links and formatting

Site-Wide Improvements

  • Header navigation: refined "Try NetBird" button styling
  • Consistent formatting and spacing across documentation pages
  • Improved visual hierarchy and navigation structure

@TechHutTV TechHutTV marked this pull request as ready for review January 13, 2026 03:20
@braginini braginini merged commit 105e677 into main Jan 13, 2026
1 check passed
@braginini braginini deleted the self-host-docs-fixes branch January 13, 2026 09:59
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