---
id: CSOC-WP-0001
type: workplan
title: "bubble.io exit assessment"
domain: communication
repo: coulomb-social
status: active
owner: bernd
topic_slug: coulomb-social
created: "2026-08-09"
updated: "2026-08-10"
origin: residual
origin_ref: the-custodian/docs/coulomb-social-rebuild-seed.md
state_hub_workstream_id: "ecefaeef-908a-4072-ae34-6406862d4cad"
---

# bubble.io exit assessment

Assess the live coulomb.social bubble.io product, export its data model, decide
the v1 feature cut, and rehearse migration into the code-owned stack.

## Operating posture (2026-08-10)

| Host | Role |
|------|------|
| **`https://coulomb.social`** | **Bubble.io** — full product, production members/content |
| **`https://app.coulomb.social`** | **Railiance rebuild** — identity live; product surfaces under construction |

**Strategy:** perfect the rebuild on `app.coulomb.social` **before** migrating all
spaces/data from Bubble. Do **not** repoint apex DNS until product + content
persistence + self-registration are ready and a migration rehearsal has passed.

Identity shell is done (`CSOC-WP-0002`). Product/content foundation is
`CSOC-WP-0004`. This workplan stays the home for **inventory, mapping, feature
cut, and migration rehearsal** — executed when the target schema/content model
exists, not as the immediate next build step.

## Inventory bubble.io app

```task
id: CSOC-WP-0001-T01
status: todo
priority: medium
state_hub_task_id: "240a97c5-1f57-4da6-a75b-d7b3416afdd1"
```

Inventory the current bubble.io app: pages, workflows, data types,
integrations, external services, and content surfaces that must be preserved
or deliberately dropped. Record findings under `docs/bubble-inventory/` (create
as needed). Prefer **spaces / pages / markdown-shaped content** first so
`CSOC-WP-0004` Forgejo persistence can map cleanly.

## Data export and schema mapping

```task
id: CSOC-WP-0001-T02
status: todo
priority: medium
state_hub_task_id: "0bc6eea3-030d-4987-b203-15ccd4f94fcb"
```

Produce a full data dump from bubble.io and map it to:

1. tenant-keyed application tables (members, space metadata, …), and  
2. **space content as markdown trees** bound to Forgejo repositories  
   (see CSOC-WP-0004 content model).

Document mapping and export under `docs/migration/`. Depends on CSOC-WP-0004
content layout decisions for lossless mapping of pages/artefacts.

## Feature cut decision (human gate)

```task
id: CSOC-WP-0001-T03
status: wait
priority: high
state_hub_task_id: "35a0af87-2f22-4fae-8c82-e3cc4f77f074"
```

Decide rebuild-as-is vs reduced v1 scope. **Human gate — Bernd.** Capture under
`docs/decisions/`. Gate **apex cutover / bulk migration**, not day-to-day
rebuild work on `app.coulomb.social`.

## Migration rehearsal

```task
id: CSOC-WP-0001-T04
status: todo
priority: low
state_hub_task_id: "2e5be321-3d76-4d7a-86b1-cbe4eb554bd7"
```

Import one or more Bubble spaces into the v1 model on a non-production path
(app host or staging). Record lossiness and residuals. **Blocked until**
CSOC-WP-0004 persistence exists and T02 mapping is written. Explicitly **not**
a prerequisite for building product UX on the empty/new content store.

## Acceptance

- Inventory and mapping docs are committed and reviewable.
- Feature-cut decision is recorded with owner and date.
- At least one migration rehearsal has been run and residual gaps listed.
- Apex Bubble retirement is only planned after rehearsal + product parity gate.

## Notes

- Parallel hosts: `docs/deploy.md`
- Next product build: `workplans/CSOC-WP-0004-app-shell-and-space-content.md`
- Service contract: `the-custodian/canon/standards/business-app-service-contract_v0.1.md`