Repo Layout & Deploy Targets

Where the code physically lives, where each piece is deployed, and which accounts own what.

The platform spans two GitHub repos and four deploy surfaces, and the source repo is not always the same as the account that hosts the deploy. This page maps it out so the question "where do I edit X and what does deploying it actually touch?" has a single answer.

TL;DR

                    Roam (ai-advisor, hosted by Roam HQ Inc.)
                          ▲
                          │ webhook
                          │
        ┌─── fcr-dashboard ── worker ──► fcr-dashboard-api.fcrmedia.workers.dev
        │   (FCR4IE/DASHBOARD)                       (FCR Cloudflare)
        │      │
        │      ├── docs/  +  scripts/build-docs-site.mjs ──► fcr-dashboard-docs.pages.dev
        │      │                                              (FCR Cloudflare)
        │      │
        │      └── services/image-normalizer/ ──► …--fcr-image-normalizer-fastapi-app.modal.run
        │                                          (cathaldempsey Modal workspace)
        │
        └─── workflowlogo-repo ── studio/ ──► creator-studio-738.pages.dev
            (DCathal/workflowlogo)              (FCR Cloudflare)
                  │
                  └── workflows/imagegen.json ──► Creator — Image Gen
                      (source-of-truth)            (fcrmedia n8n)

Two repos. Source in either FCR-owned or personal GitHub. Deploys hit FCR Cloudflare, fcrmedia n8n, and a personal Modal workspace.

The two GitHub repos

fcr-dashboard — the FCR-owned monorepo

• Remote: github.com/FCR4IE/DASHBOARD
• Local clone: ~/fcr-dashboard/
• Owner: FCR org

Anything that calls out to BQ / HubSpot / Teamwork / Ahrefs / SerpAPI / GBP / GA4 / Search Console / iovox / GMC lives in worker/src/handlers/. The advisor is worker/src/handlers/ai-advisor.js.

workflowlogo-repo — Studio + Creator n8n workflows

• Remote: github.com/DCathal/workflowlogo
• Local clone: ~/workflowlogo-repo/
• Owner: personal GitHub (Cathal). Not under FCR4IE. See Ownership gaps worth closing.

creator-workflow-restructure — local working dir (not a git repo)

• Path: ~/creator-workflow-restructure/
• Migration scripts, backup JSONs of the Creator router/agent/pack-resolver/delivery workflows, and TODO.md (open bugs noted during the migration sprint, e.g. /edit-/remix-/reframe from non-reply context).
• Not version-controlled. These are scratch files; the workflow JSONs that are source-of-truth live in workflowlogo-repo/workflows/.

The deploy surfaces

1. Cloudflare Worker — fcr-dashboard-api

Both env blocks share the same worker/ source. scripts/deploy-worker.sh deploys to both, gates on a clean worker/ git state, and writes a deploy/worker/<timestamp>-<sha> tag pushed to origin. scripts/ship.sh is the recommended entry point — it also routes docs + reindex.

2. Cloudflare Pages — three projects, all on the FCR account

The CF account holds all three Pages projects, but the project sources live in different git repos.

3. n8n — fcrmedia.app.n8n.cloud

55+ workflows. The ones in the Creator stack (per the Creator/Studio migration memory):

API token (N8N_API_KEY in .env.local) authorises surgical PUT /api/v1/workflows/:id edits. See docs/n8n-workflows.md for the broader workflow inventory.

4. Modal — fcr-image-normalizer

• URL: https://cathaldempsey--fcr-image-normalizer-fastapi-app.modal.run
• Modal workspace: cathaldempsey (personal — see Ownership gaps)
• Source: fcr-dashboard/services/image-normalizer/normalize.py
• Deploy: modal deploy services/image-normalizer/normalize.py (after modal token new once)
• Endpoints: POST /normalize (called by worker hydrateUserImages/hydrateHubspotImages), POST /composite (called by the n8n Composite Images node), GET /health
• Secrets: two Modal secrets, image-normalizer (carries FCR_NORMALIZER_TOKEN used by the worker) and image-normalizer-n8n (carries FCR_N8N_TOKEN used by n8n). Either authenticates either endpoint — the split is rotation-isolation.

Cross-repo dependencies (who calls whom)

roam advisor                    HubSpot card iframe
        │                              │
        └─────────────► dashboard-ai-advisor (worker)
                              │
              ┌───────────────┼───────────────────────┐
              ▼               ▼                       ▼
     BQ / HubSpot /    open_studio tool         generate_image
     Teamwork / etc.   ─── JWT link ──►         tool
                       creator-studio-738       │
                       (Studio app)             ▼
                       │                  creator-image-gen gateway (worker)
                       │                        │
                       │                        ▼
                       └───── HTTP POST ──► fcrmedia n8n
                              /webhook/Creator700
                                  │
                                  ▼
                              Creator router → Image Gen → Composite Images
                                                                  │
                                                                  ▼
                                                          Modal /composite
                                  ▲
                                  │
                                  └── Modal /normalize ◄── worker hydrateUserImages
                                      (HEIC/AVIF fallback)

Practical: Studio is the only piece in the personal GitHub repo. Everything else (worker, docs, Modal source, dashboard UI) is in FCR4IE/DASHBOARD. The n8n workflows are in n8n itself; only Image Gen has a JSON twin in workflowlogo-repo/workflows/.

Where the deploy lever lives for each change

For the worker-secret rotation step: wrangler secret put --env="" doesn't work for the CD/dev env — omit --env entirely and pass CLOUDFLARE_ACCOUNT_ID=1ceb8928… explicitly. --env fcr is normal.

Ownership gaps worth closing

A few pieces of the platform live in personal accounts, not under FCR org control. Production touches FCR Cloudflare + fcrmedia n8n in every case, but the source / Modal compute is personal. If the maintainer changes, these would need transfer to remain accessible:

• github.com/DCathal/workflowlogo — Studio frontend + Image Gen workflow JSON. Should be transferred to FCR4IE (or mirrored into fcr-dashboard as a studio/ subtree).
• cathaldempsey Modal workspace — /normalize + /composite run on a personal Modal account. Should be moved to an FCR Modal org workspace if one is created.

Neither blocks day-to-day work; both are organisational hygiene for handover/continuity.

Why "split" repos at all?

Studio was a personal experiment (Creator/Studio migration onto the FCR stack, 2026-05-25) that proved out and moved its deploy targets (CF Pages, n8n, R2) onto the FCR stack — but the source repo didn't migrate with the deploys. Same for Modal: chosen for time-to-ship (scale-to-zero, single-file deploy), but the workspace is personal because that's whose Modal account was set up.

The deploy outcome is correct (everything runs on FCR infrastructure that the team controls). The source ownership is the residual cleanup.

FCR Dashboard documentation · generated from docs/ · keep counts verified, not guessed.