Web app overview
The web app at app.tradingcards.dev does three things:
- Snapshot a HubSpot portal: read its configuration and a sample of its records, and keep a browsable copy.
- Recipe: bundle the parts worth handing on into a named set you can export as a file and import elsewhere.
- 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.
Screens
Section titled “Screens”The sidebar lists every screen. Each one has its own address, so the browser’s back and forward buttons work.
| Screen | Path | What 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 | /recipes | Your recipes. Open one to see its assets, where it is deployed, and whether a deployment is behind. |
| Apps | /apps | The Trading Cards app catalogue. Filter by category, or show only what is installed. |
| Portals | /portals/:id | One page per connected portal: its keys, snapshots, what is deployed there, and its recent jobs. |
| Activity | /activity | Every job: deploys, scans, snapshots and asset pushes, with progress, a log and results. |
| Account | /account | Profile, 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.