Web app: App shell, onboarding, GitHub connect, and project UI (Phase 3)

New authenticated app shell, onboarding flow, and project workflows — Redesigned the authenticated experience with a persistent left sidebar, added a 4‑step onboarding wizard, a 3‑step project creation flow (GitHub install → repo select → project config), and a project dashboard with entry lists and project settings. GitHub App install redirects are handled and tied into project creation.

Added a persistent left sidebar app shell with a ProjectSwitcher, project‑scoped nav (Home / Settings / Analytics / Editor / Branding) and workspace nav (Organization, Billing, Account).frontend
Added a 4‑step onboarding wizard: Welcome → Create workspace (Clerk) → Connect GitHub → Done, with progress and URL-driven step state.frontend
Added a 3‑step project creation wizard: Connect GitHub (auto-skip if installation exists) → Select repository → Configure project (form validation with Zod and RHF).frontend
Added project dashboard (ProjectGrid + ProjectCard), project home (entry list with EntryCard and skeleton loading) and slim project header showing repo and sync status.frontend
Added project settings page with 4 tabs (General, GitHub, Changelog, Danger Zone) and placeholder Billing page; analytics/editor/branding pages were added as shared "Coming Soon" stubs.frontend
Integrated Clerk organization and user profile UIs into app settings to manage orgs and members from the web app.auth

Added Next.js route handlers for server-backed reads: GET /api/projects, GET /api/projects/[slug], GET /api/projects/[slug]/entries and GET /api/github/installations.backend
Added a GitHub callback page (/github/callback) that calls the Express API callback and redirects users into the web app project creation flow.integrations
Added a lightweight database helper (getDb) and added @suprlogs/database dependency so server components and API routes can load projects and settings from the DB.database
Added client hooks for data fetching: useProjects, useEntries, useGithubInstallations, and useGithubRepos (TanStack Query).frontend

Redesigned the server layout to load the project list and pass initial projects into the Sidebar to avoid a loading flash.frontend
Implemented extractActiveSlug(util) and updated Sidebar to use usePathname() to determine the active project context.frontend
Installed a set of shared UI primitives (Shadcn + Radix pieces) and added multiple UI components (badge, dialog, popover, select, tabs, progress, etc.) to standardize the app look-and-feel.frontend
Updated middleware to exempt /api/* routes from Clerk redirect so API handlers can return 401/403 directly instead of being redirected to sign-in.auth
Added client-side UX polish: skeleton loading, status badges, progress bars, and consistent neobrutalist styling across new pages.frontend

Updated README to instruct using the web app callback URL (/github/callback) and to document new environment variables (NEXT_PUBLIC_API_URL, API_URL, NEXT_PUBLIC_GITHUB_APP_SLUG).docs
Added NEXT_PUBLIC_GITHUB_APP_SLUG to .env and NEXT_PUBLIC_API_URL / API_URL to .env.development to support browser-side GitHub install links and local API calls.docs
Updated package.json and tooling for the web app: added vitest support and test scripts for the new web tests.devops

Updated GitHub App callback expectations — update your GitHub App's callback URL to the web app (/github/callback) and set NEXT_PUBLIC_API_URL and NEXT_PUBLIC_GITHUB_APP_SLUG in your web app environment so the install flow and API calls work correctly.integrations