fix: add icon list by ogzhanolguncu · Pull Request #5163 · unkeyed/unkey

ogzhanolguncu · 2026-03-02T16:22:05Z

What does this PR do?

Adds a comprehensive project onboarding flow with GitHub integration. The onboarding includes a step wizard for creating projects, connecting GitHub repositories, and selecting repositories with branch selection. The flow features repository filtering by owner, search functionality, Dockerfile detection, and branch selection with a responsive UI that includes loading states and success notifications.

Fixes # (issue)

Type of change

Bug fix (non-breaking change which fixes an issue)
Chore (refactoring code, technical debt, workflow improvements)
Enhancement (small improvements)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
This change requires a documentation update

How should this be tested?

Navigate to projects page with ?onboarding query parameter to trigger onboarding flow
Test GitHub repository selection with different owners and search queries
Verify Dockerfile detection works correctly for repositories
Test branch selection dropdown functionality
Verify success notifications appear when GitHub is connected
Test repository filtering and search functionality

Checklist

Required

Appreciated

If a UI change was made: Added a screen recording or screenshots to this PR
Updated the Unkey Docs if changes were necessary

vercel · 2026-03-02T16:22:12Z

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

Project	Deployment	Actions	Updated (UTC)
dashboard	Ready	Preview, Comment	Mar 3, 2026 7:42am

ogzhanolguncu · 2026-03-02T16:22:16Z

refactor: quality of life changes #5176
Rename /onboarding to /new #5168
fix: ui inconsistencies #5167
feat: allow triggering initial deploy from dashboard #5166
feat: apply settings to every env #5165
refactor: allow projectId prop for ProjectDataProvider #5164
fix: add icon list #5163 👈 (View in Graphite)
feat: add step-wizard #5162
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

coderabbitai · 2026-03-02T16:22:19Z

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between db737e8 and 8bed7eb.

📒 Files selected for processing (16)

web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/index.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/onboarding-header.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/connect-github.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/create-project.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/onboarding-links.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/select-repo/index.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/select-repo/repo-list-item.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/select-repo/skeleton.tsx
web/apps/dashboard/app/(app)/[workspaceSlug]/projects/projects-client.tsx
web/apps/dashboard/app/(app)/integrations/github/callback/page.tsx
web/apps/dashboard/components/virtual-table/components/empty-state.tsx
web/apps/dashboard/lib/github.ts
web/apps/dashboard/lib/trpc/routers/github.ts
web/internal/icons/src/icons/discord.tsx
web/internal/icons/src/index.ts
web/internal/ui/src/components/step-wizard/step-wizard.tsx

📝 Walkthrough

Walkthrough

This PR introduces a multi-step GitHub onboarding wizard for projects, featuring UI components for project creation, GitHub connection, and repository selection. It includes GitHub API helpers with Zod schema validation, new TRPC procedures for repository operations, and integrates the onboarding flow into the projects client.

Changes

Cohort / File(s)	Summary
Onboarding Wizard Components `web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/index.tsx`, `onboarding-header.tsx`	Core onboarding page with StepWizard orchestration and header component that renders progress, success banners, and step-specific titles/subtitles with icon rows.
Onboarding Step Components `web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/create-project.tsx`, `connect-github.tsx`, `onboarding-links.tsx`	Step components for project creation (with form validation and slug generation), GitHub connection (with app installation link), and documentation/Discord links.
Repository Selection Step `web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/select-repo/index.tsx`, `repo-list-item.tsx`, `skeleton.tsx`	Repository selection UI with owner filtering, search, branch selection, Dockerfile detection, and loading skeletons.
GitHub API Helpers & Validation `web/apps/dashboard/lib/github.ts`	Introduces Zod schemas for GitHub API responses (repositories, access tokens, branches, tree) and exports GitHubRepository type; adds validation-based parsing and new utility functions getRepositoryTree and getRepositoryBranches.
TRPC GitHub Router `web/apps/dashboard/lib/trpc/routers/github.ts`	Adds new getRepositoryDetails procedure to fetch repository structure and branches; extends listRepositories with pushedAt field.
Integration & Supporting Components `web/apps/dashboard/app/(app)/[workspaceSlug]/projects/projects-client.tsx`, `web/apps/dashboard/app/(app)/integrations/github/callback/page.tsx`, `web/apps/dashboard/components/virtual-table/components/empty-state.tsx`	Conditional rendering of onboarding flow based on query parameter; removes post-mutation redirect in GitHub callback; updates docs link in empty state.
Icon & UI Library Updates `web/internal/icons/src/icons/discord.tsx`, `web/internal/icons/src/index.ts`, `web/internal/ui/src/components/step-wizard/step-wizard.tsx`	Adds Discord icon component, exports it, and refactors StepWizard layout transitions from absolute positioning to flow-based with improved overflow handling.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Onboarding as Onboarding Page
    participant CreateProject as CreateProjectStep
    participant ConnectGH as ConnectGithubStep
    participant SelectRepo as SelectRepo
    participant TRPC as TRPC Backend
    participant GitHub as GitHub API

    User->>Onboarding: View onboarding
    activate Onboarding
    
    Onboarding->>CreateProject: Render step 1
    activate CreateProject
    User->>CreateProject: Enter project name
    CreateProject->>TRPC: Insert project
    TRPC->>TRPC: Create project record
    TRPC-->>CreateProject: Project created with ID
    CreateProject->>Onboarding: onProjectCreated(projectId)
    Onboarding->>Onboarding: setProjectId(projectId)
    deactivate CreateProject
    
    Onboarding->>ConnectGH: Render step 2 with projectId
    activate ConnectGH
    User->>ConnectGH: Click "Connect GitHub"
    ConnectGH->>GitHub: Redirect to GitHub App install<br/>(with projectId in state)
    deactivate ConnectGH
    
    GitHub-->>User: Complete installation
    User->>Onboarding: Return to app
    
    Onboarding->>SelectRepo: Render step 3 with projectId
    activate SelectRepo
    SelectRepo->>TRPC: Fetch repositories for projectId
    TRPC->>GitHub: List repositories
    GitHub-->>TRPC: Repository list
    TRPC-->>SelectRepo: Repositories with pushedAt
    
    User->>SelectRepo: Filter by owner & search
    SelectRepo->>TRPC: getRepositoryDetails(projectId, repo)
    TRPC->>GitHub: Fetch tree & branches
    GitHub-->>TRPC: Structure & branches
    TRPC-->>SelectRepo: hasDockerfile, branch list
    
    User->>SelectRepo: Select repository & branch
    SelectRepo->>TRPC: Connect repository
    TRPC->>TRPC: Store repo connection
    TRPC-->>SelectRepo: Success
    deactivate SelectRepo
    
    deactivate Onboarding

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

✨ Finishing Touches

📝 Generate docstrings (stacked PR)
📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch feat/onboarding-page

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/onboarding-links.tsx

graphite-app · 2026-03-03T07:40:45Z

Merge activity

Mar 3, 7:40 AM UTC: Graphite rebased this pull request, because this pull request is set to merge when ready.

ogzhanolguncu mentioned this pull request Mar 2, 2026

feat: add step-wizard #5162

Merged

19 tasks

This was referenced Mar 2, 2026

refactor: allow projectId prop for ProjectDataProvider #5164

Merged

feat: apply settings to every env #5165

Merged

feat: allow triggering initial deploy from dashboard #5166

Merged

fix: ui inconsistencies #5167

Merged

vercel bot had a problem deploying to Preview March 2, 2026 16:24 Failure

ogzhanolguncu mentioned this pull request Mar 2, 2026

Rename /onboarding to /new #5168

Merged

19 tasks

ogzhanolguncu marked this pull request as ready for review March 2, 2026 17:18

ogzhanolguncu requested review from Flo4604, MichaelUnkey, chronark, imeyer, mcstepp and perkinsjr as code owners March 2, 2026 17:18

vercel bot had a problem deploying to Preview March 2, 2026 17:25 Failure

chronark reviewed Mar 2, 2026

View reviewed changes

web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/onboarding-links.tsx Show resolved Hide resolved

chronark reviewed Mar 2, 2026

View reviewed changes

web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/onboarding-links.tsx Outdated Show resolved Hide resolved

chronark reviewed Mar 2, 2026

View reviewed changes

web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/onboarding-links.tsx Outdated Show resolved Hide resolved

chronark reviewed Mar 2, 2026

View reviewed changes

web/apps/dashboard/app/(app)/[workspaceSlug]/projects/(onboarding)/steps/onboarding-links.tsx Outdated Show resolved Hide resolved

chronark requested changes Mar 2, 2026

View reviewed changes

vercel bot had a problem deploying to Preview March 2, 2026 17:45 Failure

vercel bot had a problem deploying to Preview March 2, 2026 17:58 Failure

ogzhanolguncu requested a review from chronark March 2, 2026 18:04

vercel bot deployed to Preview March 2, 2026 18:06 View deployment

Base automatically changed from feat-step-wizard to main March 3, 2026 07:39

ogzhanolguncu added 2 commits March 3, 2026 07:40

fix: add icon list

4e5d2d5

feat: add first step

c1ea45c

ogzhanolguncu added 10 commits March 3, 2026 07:40

fix: overflow

2ba13d2

feat: make structure more organized

1b34f22

feat: add callout to top

16b05e9

feat: add project creation

4712870

feat: add repo selection

69ad801

chore: tidy up github

5d7df92

chore: fmt

adbd994

fix: comments

fb3225e

fix: build issue

e6a0cfa

fix: missing path

8bed7eb

ogzhanolguncu force-pushed the feat/onboarding-page branch from f34edea to 8bed7eb Compare March 3, 2026 07:40

chronark approved these changes Mar 3, 2026

View reviewed changes

chronark enabled auto-merge March 3, 2026 07:40

chronark disabled auto-merge March 3, 2026 07:42

chronark merged commit 09ccb61 into main Mar 3, 2026
12 of 14 checks passed

vercel bot deployed to Preview March 3, 2026 07:42 View deployment

chronark deleted the feat/onboarding-page branch March 3, 2026 07:42

ogzhanolguncu mentioned this pull request Mar 3, 2026

refactor: quality of life changes #5176

Merged

19 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix: add icon list#5163

fix: add icon list#5163
chronark merged 12 commits intomainfrom
feat/onboarding-page

ogzhanolguncu commented Mar 2, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 2, 2026 •

edited

Loading

Uh oh!

ogzhanolguncu commented Mar 2, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Mar 2, 2026 •

edited

Loading

Review failed

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

graphite-app bot commented Mar 3, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ogzhanolguncu commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

Type of change

How should this be tested?

Checklist

Required

Appreciated

Uh oh!

vercel bot commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ogzhanolguncu commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

graphite-app bot commented Mar 3, 2026

Merge activity

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ogzhanolguncu commented Mar 2, 2026 •

edited

Loading

vercel bot commented Mar 2, 2026 •

edited

Loading

ogzhanolguncu commented Mar 2, 2026 •

edited

Loading

coderabbitai bot commented Mar 2, 2026 •

edited

Loading