Skip to content

Using Packs

Jump to bottom
Christophe Babilotte edited this page Dec 25, 2025 · 4 revisions

Using Packs and Marketplaces

Packs are bundles of templates and libraries you can install directly from the app. They're the fastest way to add new project starters to ProjectHub.

Marketplaces

A marketplace is a source of packs. ProjectHub supports multiple marketplaces so you can combine packs from different sources:

  • Official Marketplace – Built-in, contains official packs like react-pack and python-pack
  • Custom Marketplaces – Add your team's private packs or community marketplaces

Browsing and Installing Packs

Click Marketplace in the sidebar to browse available packs:

  1. Browse the card gallery showing all packs from enabled marketplaces
  2. Use category filter chips to narrow by type: Frontend, Backend, Fullstack, Configuration
  3. Each card shows:
    • Pack icon and name
    • Info icon (hover to see full details: technology, category, license, version, release date)
    • Official badge (for official marketplace packs) or marketplace source
    • Description
    • Version info (amber if update available)
  4. Click the download icon to install a pack
  5. Click the trash icon to remove an installed pack
  6. Use the search bar to filter packs by name or description

Managing Marketplace Sources

To configure which marketplaces ProjectHub fetches packs from:

  1. Open Settings → Marketplace tab
  2. You'll see a list of configured marketplaces with pack counts
  3. The Official marketplace is always present and cannot be removed

Add a marketplace

  1. In the input field at the bottom, enter:
    • GitHub shorthand: owner/repo (e.g., acme/projecthub-packs)
    • Or a full URL: https://github.com/acme/projecthub-packs/releases/latest
  2. Click Add
  3. The marketplace is added and its packs appear in the Marketplace gallery

Remove a marketplace

Click the trash icon next to a custom marketplace. This only removes the marketplace from your sources—it doesn't delete any installed packs.

Enable/disable a marketplace

Use the checkbox next to each marketplace to enable or disable it. Disabled marketplaces won't be fetched.

Check for updates

In the Marketplace gallery, packs with available updates show version info in amber (e.g., v0.1.1 → v0.2.1). Click the download icon to update.

Refresh the list

Click Refresh in the Marketplace page to fetch the latest packs from all enabled marketplaces.

Available official packs

The official marketplace includes:

  • react-pack – React + TypeScript + Vite templates
  • python-pack – Python project starters with ruff, mypy, pytest

Where marketplace config is stored

Marketplace sources are stored in ~/.projecthub/marketplace/metadata.yml:

version: 1
marketplaces:
  - id: official
    name: ProjectHub Official
    url: https://github.com/cbabil/projecthub-packs/releases/latest
    isOfficial: true
    enabled: true
  - id: acme-packs
    name: acme/custom-packs
    url: https://github.com/acme/custom-packs/releases/latest
    enabled: true

Troubleshooting

"Some marketplaces failed to load"

Check the Settings → Marketplace tab for error details on specific marketplaces. Common causes:

  • GitHub rate limit reached—wait a few minutes and try again
  • Invalid marketplace URL
  • Network connection issues

Pack not showing after install

Click Refresh in the Marketplace page, or restart the app to reload templates.

Marketplace error

If a specific marketplace fails to fetch, an error appears in Settings. Other marketplaces continue to work normally.

Creating your own marketplace

See the ProjectHub Packs Wiki for instructions on creating and publishing your own pack marketplace.

Clone this wiki locally