Skip to content

Web app overview

The web app at app.tradingcards.dev does three things:

  1. Snapshot a HubSpot portal: read its configuration and a sample of its records, and keep a browsable copy.
  2. Recipe: bundle the parts worth handing on into a named set you can export as a file and import elsewhere.
  3. Deploy a recipe, a snapshot, or a pre-built app into any portal you have connected.

Everything runs through the app’s own server. The browser never talks to HubSpot and never holds a key.

The sidebar lists every screen. Each one has its own address, so the browser’s back and forward buttons work.

ScreenPathWhat it shows
Library/Everything you own in one deck: recipes (books) and apps (trading cards). Search, Import, New recipe. Tabs: All, Recipes, Apps, Shared with you.
Recipes/recipesYour recipes. Open one to see its assets, where it is deployed, and whether a deployment is behind.
Apps/appsThe Trading Cards app catalogue. Filter by category, or show only what is installed.
Portals/portals/:idOne page per connected portal: its keys, snapshots, what is deployed there, and its recent jobs.
Activity/activityEvery job: deploys, scans, snapshots and asset pushes, with progress, a log and results.
Account/accountProfile, photo, theme, sessions, sign out, delete account.

Under Portals the sidebar lists each portal with a dot: teal when it is ready, amber when it still needs keys. Under Running, Activity shows a live count of queued and running jobs. The bell at the bottom opens notifications: job starts and results, app updates, and recipes that have changed since they were deployed.

The library draws two kinds of card, the same way the app draws them:

  • Recipes are books. A spine on the left, page edges on the right. The tag reads Ready or Update.
  • Apps are trading cards. A framed card with the app’s parts counted on the face (“2 CRM cards · 1 quote module”). The tag reads Installed or Update, and the footer shows the version.

Every recipe gets a generated cover from its name: one of ten patterns and an accent colour. You can change it, or upload an image.