Skip to content

App shell: prototype-style sidebar for dashboard, explore, start - #2

Merged
abullaisi merged 1 commit into
mainfrom
design/prototype-skin
Jul 16, 2026
Merged

App shell: prototype-style sidebar for dashboard, explore, start#2
abullaisi merged 1 commit into
mainfrom
design/prototype-skin

Conversation

@abullaisi

@abullaisi abullaisi commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Presentational-only pass so the dApp matches the prototype and landing design language.

What changed

  • New collapsible left sidebar on the app pages (dashboard, explore, start): Komunify logo, member nav with icons and active states, collapse to a 64px icon rail (chevron button, state persists in localStorage), elevated card surface per the design tokens.
  • Each page is wrapped in an AppShell component. The diff on the three pages is one import plus the wrapper; nothing else.

What did NOT change

  • Zero wallet, data, or business logic. No edits to layout.tsx, globals.css tokens, community pages, or dashboard components.
  • Mobile (below 900px) keeps the current no-sidebar behavior.

Verified

  • tsc clean, normal build and static-export build both pass, all 9 routes generate.

Merge if you want it for judging; safe to leave for after. Your call.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features
    • Added a consistent application shell across Dashboard, Explore, and Start pages.
    • Added a navigational sidebar with links to Dashboard, Explore, and Start.
    • Sidebar highlights the active page and supports collapsed or expanded views.
    • Sidebar state is remembered between visits.
    • Added branding and logo access within the sidebar.

…l only)

Collapsible sidenav on the elevated card surface: logo, member nav with
icons and active states, 232px to 64px icon rail persisted in localStorage,
hidden below 900px. Pages are wrapped only; no wallet, data, or logic changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
stellar-hackathon-web Ready Ready Preview, Comment Jul 16, 2026 7:44am

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Changes

App shell navigation

Layer / File(s) Summary
Sidebar behavior and navigation
packages/web/components/app-shell/app-sidenav.tsx
Adds route-aware Dashboard, Explore, and Start navigation with collapsible state persisted in localStorage.
Shared shell composition
packages/web/components/app-shell/app-shell.tsx
Adds a flex-based AppShell containing AppSidenav and the page content region.
Page shell integration
packages/web/app/dashboard/page.tsx, packages/web/app/explore/page.tsx, packages/web/app/start/page.tsx
Renders each page’s existing content through AppShell.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Page
  participant AppShell
  participant AppSidenav
  participant localStorage
  Page->>AppShell: Render page content as children
  AppShell->>AppSidenav: Render shared sidebar
  AppSidenav->>localStorage: Load persisted collapsed state
  AppSidenav->>AppSidenav: Match current pathname and render active item
  AppSidenav->>localStorage: Persist toggle changes
  AppShell-->>Page: Render sidebar with page content
Loading

Suggested reviewers: yoms07

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main change: adding an app shell with a prototype-style sidebar to the dashboard, explore, and start pages.
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.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch design/prototype-skin

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

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/web/components/app-shell/app-shell.tsx (1)

5-12: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add min-w-0 to the flex child.

By default, flex children have min-width: auto, meaning they cannot shrink below the intrinsic width of their content. If the children contain wide elements (like code blocks, data tables, or long strings without wrapping), it will force this wrapper to expand beyond the viewport and break the layout. Adding min-w-0 prevents this and allows internal content to truncate or scroll properly.

♻️ Proposed refactor
 export function AppShell({ children }: { children: ReactNode }) {
   return (
     <div className="flex min-h-screen">
       <AppSidenav />
-      <div className="flex-1">{children}</div>
+      <div className="flex-1 min-w-0">{children}</div>
     </div>
   );
 }
🤖 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/web/components/app-shell/app-shell.tsx` around lines 5 - 12, Update
the flex child wrapper next to AppSidenav in AppShell to include the Tailwind
min-w-0 utility, allowing children content to shrink within the available
viewport while preserving the existing flex-1 behavior.
🤖 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/web/app/dashboard/page.tsx`:
- Around line 5-7: Move the shared AppShell wrapper into a persistent Next.js
route-group layout, such as app/(main)/layout.tsx, and place the dashboard,
explore, and start routes under that group. In
packages/web/app/dashboard/page.tsx lines 5-7, packages/web/app/explore/page.tsx
lines 6-8, and packages/web/app/start/page.tsx lines 5-7, remove the AppShell
wrappers and restore each page’s prior return structure so the layout owns the
shell across navigation.

---

Nitpick comments:
In `@packages/web/components/app-shell/app-shell.tsx`:
- Around line 5-12: Update the flex child wrapper next to AppSidenav in AppShell
to include the Tailwind min-w-0 utility, allowing children content to shrink
within the available viewport while preserving the existing flex-1 behavior.
🪄 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 Plus

Run ID: 6ea2c276-fc65-4586-beb7-5a40b6b47bb6

📥 Commits

Reviewing files that changed from the base of the PR and between e2e0ffd and 6e47424.

📒 Files selected for processing (5)
  • packages/web/app/dashboard/page.tsx
  • packages/web/app/explore/page.tsx
  • packages/web/app/start/page.tsx
  • packages/web/components/app-shell/app-shell.tsx
  • packages/web/components/app-shell/app-sidenav.tsx

Comment on lines 5 to 7
return (
<main className="shell">
<DashboardShell />
</main>
<AppShell><main className="shell"><DashboardShell /></main></AppShell>
);

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟠 Major | 🏗️ Heavy lift

Move the shared AppShell wrapper to a Next.js layout to prevent state loss on navigation.

Placing the shared AppShell component inside individual page.tsx files causes it to completely unmount and remount on every route transition between these pages. Because AppSidenav initializes its collapsed state to false and updates it via a client-side useEffect, this unmounting causes the sidebar to "forget" its state during navigation. As a result, the sidebar will revert to its expanded state and visibly animate closed on every single page transition.

To preserve UI state and avoid unnecessary re-renders, shared shells must be implemented in a Next.js layout.tsx file rather than wrapping each page component individually. The idiomatic approach is to create a Route Group (e.g., app/(main)/layout.tsx returning the AppShell) and move these specific routes inside it.

  • packages/web/app/dashboard/page.tsx#L5-L7: Remove the <AppShell> wrapper and restore the previous return structure.
  • packages/web/app/explore/page.tsx#L6-L8: Remove the <AppShell> wrapper and restore the previous return structure.
  • packages/web/app/start/page.tsx#L5-L7: Remove the <AppShell> wrapper and restore the previous return structure.
📍 Affects 3 files
  • packages/web/app/dashboard/page.tsx#L5-L7 (this comment)
  • packages/web/app/explore/page.tsx#L6-L8
  • packages/web/app/start/page.tsx#L5-L7
🤖 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/web/app/dashboard/page.tsx` around lines 5 - 7, Move the shared
AppShell wrapper into a persistent Next.js route-group layout, such as
app/(main)/layout.tsx, and place the dashboard, explore, and start routes under
that group. In packages/web/app/dashboard/page.tsx lines 5-7,
packages/web/app/explore/page.tsx lines 6-8, and packages/web/app/start/page.tsx
lines 5-7, remove the AppShell wrappers and restore each page’s prior return
structure so the layout owns the shell across navigation.

@abullaisi
abullaisi merged commit b67eb7e into main Jul 16, 2026
4 checks passed
@abullaisi
abullaisi deleted the design/prototype-skin branch July 16, 2026 08:00
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.

1 participant