Skip to content

feat(aurora): add branding slots, appName and pageFooter#929

Merged
taymoor89 merged 2 commits into
mainfrom
804-branding-slots
Jun 17, 2026
Merged

feat(aurora): add branding slots, appName and pageFooter#929
taymoor89 merged 2 commits into
mainfrom
804-branding-slots

Conversation

@taymoor89

@taymoor89 taymoor89 commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a branding and extensibility layer to AuroraApp via the slot system, allowing consumers to customise the logo, app name, and page footer without forking the package.

Changes Made

  • slots.logo: new slot that replaces the default Aurora SVG in the page header (renders outside shadow DOM, inherits header styles)
  • slots.pageFooter: new slot that replaces the default empty page footer (renders outside shadow DOM)
  • appName: new string prop — shown in the header breadcrumb and as the default logo title; defaults to "Aurora"
  • Slot component: new useShadowDOM prop (default true) to opt out of shadow DOM isolation per slot
  • README.md: updated configuration reference tables, added full Slots section, scoped docs to package API only
  • AuroraApp.tsx: added JSDoc to all public types (SlotProps, Slots, AuroraAppProps)
  • commitlint.config.mjs: replaced aurora-portal scope with aurora
  • apps/dashboard: wires up VITE_APP_TITLE env var for the page title; moves favicon.ico into the app assets

Related Issues

Testing Instructions

  1. pnpm i
  2. pnpm --filter @cobaltcore-dev/aurora typecheck
  3. pnpm --filter @cobaltcore-dev/dashboard typecheck

Checklist

  • I have performed a self-review of my code.
  • I have commented my code, particularly in hard-to-understand areas.
  • I have added tests that prove my fix is effective or that my feature works.
  • New and existing unit tests pass locally with my changes.
  • I have made corresponding changes to the documentation (if applicable).
  • My changes generate no new warnings or errors.

Summary by CodeRabbit

  • New Features

    • Added branding customization support: configurable logo component, custom footer component, and customizable app name to personalize the Aurora interface.
  • Documentation

    • Updated README with comprehensive branding customization guide, including slots configuration, usage examples, and styling guidance.
  • Chores

    • Updated environment configuration and commit scope conventions.

@taymoor89 taymoor89 requested a review from a team as a code owner June 17, 2026 08:28
@taymoor89 taymoor89 force-pushed the 804-branding-slots branch from b50d3f4 to 7e42a48 Compare June 17, 2026 08:32
@taymoor89 taymoor89 changed the title feat(aurora-portal): add branding slots, appName and pageFooter feat(aurora): add branding slots, appName and pageFooter Jun 17, 2026
@taymoor89 taymoor89 force-pushed the 804-branding-slots branch 3 times, most recently from 16a44cd to 8803ba9 Compare June 17, 2026 08:38
@taymoor89 taymoor89 self-assigned this Jun 17, 2026
@taymoor89 taymoor89 requested a review from Copilot June 17, 2026 08:42

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

Adds a lightweight branding/extensibility layer to @cobaltcore-dev/aurora’s AuroraApp by introducing new slot hooks (logo + footer) and an appName prop, enabling consumers to customize header/footer branding without forking.

Changes:

  • Added appName to router/app context and render path to replace hardcoded “Aurora” in the main header.
  • Added new slots: slots.logo (header) and slots.pageFooter (AppShell footer), plus a Slot option to disable Shadow DOM per-render.
  • Updated package docs/changeset and dashboard app template to use VITE_APP_TITLE for the HTML <title>.

Reviewed changes

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

Show a summary per file
File Description
packages/aurora/src/client/routes/__root.tsx Plumbs appName/slots through route context and renders optional pageFooter slot.
packages/aurora/src/client/components/Slot.tsx Adds useShadowDOM toggle to allow slots to render outside Shadow DOM when needed.
packages/aurora/src/client/components/navigation/MainNavigation.tsx Uses appName fallback + supports slots.logo to replace the default SVG logo.
packages/aurora/src/client/AuroraApp.tsx Extends public types/JSDoc to include new slots and appName.
packages/aurora/src/client/App.tsx Passes appName through to router context.
packages/aurora/README.md Documents new appName/slots API and slot usage examples.
commitlint.config.mjs Updates allowed commit scope from aurora-portal to aurora.
apps/dashboard/src/client/index.html Sets HTML title via %VITE_APP_TITLE%.
apps/dashboard/.env.example Adds VITE_APP_TITLE example value.
.changeset/branding-slots.md Declares minor release for branding slots + appName.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/aurora/src/client/components/Slot.tsx
Comment thread packages/aurora/src/client/components/navigation/MainNavigation.tsx
Comment thread apps/dashboard/src/client/index.html
@coderabbitai

coderabbitai Bot commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@taymoor89, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 7 minutes and 8 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d5662f13-498b-4c20-bf11-62395714ba66

📥 Commits

Reviewing files that changed from the base of the PR and between 8803ba9 and f556a49.

⛔ Files ignored due to path filters (1)
  • apps/dashboard/src/client/assets/favicon.ico is excluded by !**/*.ico
📒 Files selected for processing (12)
  • .changeset/branding-slots.md
  • apps/dashboard/.env.example
  • apps/dashboard/src/client/index.html
  • commitlint.config.mjs
  • packages/aurora/README.md
  • packages/aurora/src/client/App.tsx
  • packages/aurora/src/client/AuroraApp.tsx
  • packages/aurora/src/client/components/Slot.test.tsx
  • packages/aurora/src/client/components/Slot.tsx
  • packages/aurora/src/client/components/navigation/MainNavigation.test.tsx
  • packages/aurora/src/client/components/navigation/MainNavigation.tsx
  • packages/aurora/src/client/routes/__root.tsx
📝 Walkthrough

Walkthrough

Adds appName prop and two new slot extension points (slots.logo, slots.pageFooter) to AuroraApp. Threads appName and slots through AppRouterContextAuroraLayoutMainNavigation/AppShell. Extends Slot with a useShadowDOM option. Updates README, changeset, dashboard env config, and commitlint scope.

Changes

Aurora Branding Slot Extensions

Layer / File(s) Summary
Public types: SlotProps, Slots, AuroraAppProps
packages/aurora/src/client/AuroraApp.tsx, packages/aurora/src/client/components/navigation/MainNavigation.tsx, packages/aurora/src/client/App.tsx
SlotProps gains a typed auroraContext.client; Slots adds logo and pageFooter extension points; AuroraAppProps and NavigationProps add optional appName; AppProps declares appName?: string.
Slot component: useShadowDOM option
packages/aurora/src/client/components/Slot.tsx
Adds useShadowDOM prop (default true) to Slot; when false, renders slot content directly without the SlotShadowRoot wrapper.
appName threading: App → RouterContext → RouterProvider
packages/aurora/src/client/App.tsx, packages/aurora/src/client/routes/__root.tsx
appName is passed from App through AppInner into routerContext; RouterContext interface gains the optional appName field; Slot is imported into the root route.
AuroraLayout and MainNavigation render paths
packages/aurora/src/client/routes/__root.tsx, packages/aurora/src/client/components/navigation/MainNavigation.tsx
AuroraLayout reads appName/slots from route context and passes them to MainNavigation and AppShell.pageFooter. MainNavigation conditionally renders slots.logo via Slot or falls back to the bundled Logo using a derived displayName.
README, changeset, dashboard config, and commitlint
packages/aurora/README.md, .changeset/branding-slots.md, apps/dashboard/.env.example, apps/dashboard/src/client/index.html, commitlint.config.mjs
README revised with updated quick-start, expanded props/config tables, and a new Slots section with shadow DOM guidance. Changeset records minor bump. Dashboard adds VITE_APP_TITLE env var and dynamic HTML title. Commitlint scope renamed from aurora-portal to aurora.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • cobaltcore-dev/aurora-dashboard#876: Introduced the original Aurora slot system (sideNavBanner) and the Slot/SlotShadowRoot infrastructure that this PR extends with logo, pageFooter, useShadowDOM, and appName.

Suggested reviewers

  • andypf

Poem

🐇 Hop hop, a logo slot appears,
Where "Aurora" text once ruled the header!
A footer slot blooms, the shadow DOM steers,
appName flows down—the context is better.
No hardcoded strings, just props so neat,
This bunny declares: the branding's complete! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main changes: adding branding customization features (slots for logo and pageFooter) and the appName prop to the Aurora component.
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.
Description check ✅ Passed The PR description follows the template structure comprehensively, including all major sections with clear, detailed information about changes and testing.

✏️ 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 804-branding-slots

Warning

Review ran into problems

🔥 Problems

Stopped waiting for pipeline failures after 30000ms. One of your pipelines takes longer than our 30000ms fetch window to run, so review may not consider pipeline-failure results for inline comments if any failures occurred after the fetch window. Increase the timeout if you want to wait longer or run a @coderabbit review after the pipeline has finished.


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.

@taymoor89 taymoor89 force-pushed the 804-branding-slots branch from 7a26278 to bd706f6 Compare June 17, 2026 09:05

@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: 1

🧹 Nitpick comments (1)
packages/aurora/src/client/App.tsx (1)

21-27: ⚡ Quick win

Unify AppProps with exported AuroraAppProps to avoid contract drift.

Line 21 redefines the public prop contract locally; that duplicates AuroraAppProps and can silently diverge on future API changes.

♻️ Suggested refactor
-import type { Slots } from "./AuroraApp"
+import type { AuroraAppProps } from "./AuroraApp"

-type AppProps = {
-  theme?: "theme-dark" | "theme-light"
-  bffEndpoint?: string
-  onThemeChange?: (theme: "theme-dark" | "theme-light") => void
-  slots?: Slots
-  appName?: string
-}
+type AppProps = AuroraAppProps
🤖 Prompt for 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.

In `@packages/aurora/src/client/App.tsx` around lines 21 - 27, The AppProps type
definition is duplicating the exported AuroraAppProps contract, which can cause
them to drift apart during future updates. Remove the local AppProps type
definition and replace all references to it with the exported AuroraAppProps
type to ensure a single source of truth for the App component's prop contract.
🤖 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 `@packages/aurora/README.md`:
- Around line 23-33: The README code snippet uses top-level await with the
createServer call, but doesn't clarify the ESM/TLA (ECMAScript Modules/Top-Level
Await) requirement or provide an alternative for CommonJS users. Add a note
explaining that this snippet requires ESM support, or alternatively, wrap the
entire code block (including the createServer call and server.listen call) in an
async IIFE function to make it compatible with CommonJS setups.

---

Nitpick comments:
In `@packages/aurora/src/client/App.tsx`:
- Around line 21-27: The AppProps type definition is duplicating the exported
AuroraAppProps contract, which can cause them to drift apart during future
updates. Remove the local AppProps type definition and replace all references to
it with the exported AuroraAppProps type to ensure a single source of truth for
the App component's prop contract.
🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: abf18ffe-8b66-4daa-b988-74458102b994

📥 Commits

Reviewing files that changed from the base of the PR and between 7b80141 and 8803ba9.

⛔ Files ignored due to path filters (1)
  • apps/dashboard/src/client/assets/favicon.ico is excluded by !**/*.ico
📒 Files selected for processing (10)
  • .changeset/branding-slots.md
  • apps/dashboard/.env.example
  • apps/dashboard/src/client/index.html
  • commitlint.config.mjs
  • packages/aurora/README.md
  • packages/aurora/src/client/App.tsx
  • packages/aurora/src/client/AuroraApp.tsx
  • packages/aurora/src/client/components/Slot.tsx
  • packages/aurora/src/client/components/navigation/MainNavigation.tsx
  • packages/aurora/src/client/routes/__root.tsx

Comment thread packages/aurora/README.md
@taymoor89 taymoor89 force-pushed the 804-branding-slots branch from bd706f6 to f556a49 Compare June 17, 2026 09:43

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 12 out of 13 changed files in this pull request and generated 2 comments.

Comment thread packages/aurora/README.md
Comment thread packages/aurora/README.md
@taymoor89 taymoor89 merged commit 33ac5e9 into main Jun 17, 2026
21 of 22 checks passed
@taymoor89 taymoor89 deleted the 804-branding-slots branch June 17, 2026 11:34
@coderabbitai coderabbitai Bot mentioned this pull request Jun 29, 2026
6 tasks
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.

[Task](aurora-dashboard): Allow consumer-specific branding [Task](context): implement pagefooter

4 participants