Projects empty state has no 'Create project' CTA — first project can only be created from the CLI

Open Beginner friendly
#2,585 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
84/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Quiet
Tech stack
typescript
Domain
desktop, frontend

Research direction

Start in desktop/src/features/projects/ui/ProjectCards.tsx at EmptyState, then inspect the empty-list early return in ProjectsView.tsx and the existing create flow in ProjectsCreateMenu.tsx. Reuse the existing CreateProjectDialog entry point so the empty Projects view shows a Create project CTA, and verify that it opens the same dialog when no projects exist.

Written by the indexing model from the issue text.

Description

Summary

In the desktop app's Projects view, when there are zero projects the empty state is the only thing rendered — and it contains no way to create a project. The single UI entry point for creating a project (the "+" ProjectsCreateMenu in the projects navigation bar) lives inside the populated view, which is skipped by an early return when the list is empty.

As a result, the first project can only be created from the CLI (buzz repos create) or another client that publishes a NIP-34 repo announcement (kind 30617). Once at least one project exists, the "+" menu appears and creation works from the UI — so the gap is specifically the empty state, exactly when a create affordance is most needed.

Steps to reproduce
  1. Open the desktop app against a relay with no projects (kind 30617) published.
  2. Enable/open the Projects preview view.
  3. Observe the empty state: icon + "No projects yet" + "Projects published to this relay will appear here." — no button.
Expected

The empty state should offer a Create project CTA that opens the same CreateProjectDialog used by the toolbar "+" menu.

Code pointers
  • Empty state (no CTA): desktop/src/features/projects/ui/ProjectCards.tsxEmptyState
  • Early return that hides the toolbar/create menu when empty: desktop/src/features/projects/ui/ProjectsView.tsx (if (projects.length === 0) return <EmptyState />;)
  • The only create entry point today: desktop/src/features/projects/ui/ProjectsCreateMenu.tsx → opens CreateProjectDialog
Notes

Related to the projects/repo-announcement lifecycle tracked in #2326 (which covers deletion of repo announcements). This issue is about creation from the empty state.

Dominant language
Rust
Stars
33.7k
Forks
4.4k
Avg merge
1d 21h
Merged PRs (30d)
239

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from block/buzz

All issues in block/buzz

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.