Skip to content

Stop promising a PostgreSQL on its own, and fix the brownfield example - #83

Merged
shipmill-romamo[bot] merged 1 commit into
mainfrom
docs/database-claims
Oct 16, 2026
Merged

shipmill-romamo[bot] merged 1 commit into
mainfrom
docs/database-claims

Conversation

@shipmill-romamo

Copy link
Copy Markdown
Contributor

Follow-ups to the landing redesign.

A PostgreSQL on its own is not possible today (#81). A project with only a server and a PostgreSQL Service fails validation: databases[].application is required, the Application must exist, and it needs at least one component. So:

  • docs/neon-migration-guide.md: "What you need" and Step 1 say the database belongs to an application Cloudfall deploys on the same server, linking A PostgreSQL service can't be declared without an application Cloudfall deploys #81; Step 5 drops "for an app elsewhere, route it the same way"
  • site/public/index.html: the Neon rotation's note says "PostgreSQL next to your app on your server" instead of "One Service file"; the MSP section's buttons become "Bring your Ansible repo" and "Read the getting-started guide"; the pilot block's second button is "Try it yourself first"

Brownfield example: docs/brownfield-design.md declared targets: component, which operation.schema.json rejects (the same fix #22 got on the site); it now says host.

Phones: checked the live site in Chrome mobile emulation (iPhone 13 at 390px, Pixel 7 at 412px, 320px): no horizontal overflow, no console errors. Navigation and footer links and the Copy button were under 24px tall; on screens up to 560px they now get about 44px. The only small target left is an inline link inside a sentence.

Supabase stays out of the rotation: data copy dumps the whole database, so a Supabase source would carry auth/storage schemas, Supabase-only extensions and RLS policies on roles that don't exist on the target (#82).

Changelog: changelog.d/81-database-claims.md.

🤖 Generated with Claude Code

A project with only a server and a PostgreSQL service does not validate:
every database names a declared application, and an application needs a
component Cloudfall deploys (#81). The Neon guide now says so and no
longer suggests an app on another host can reach the database, and the
site's Neon note and calls to action stop offering a PostgreSQL alone.
The brownfield design's operation sample declared targets: component,
which the operation schema rejects; it uses host. On phones, the site's
navigation and footer links get a tap target of about 44px.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@shipmill-romamo
shipmill-romamo Bot merged commit 3c2d06c into main Oct 16, 2026
1 check passed
@shipmill-romamo
shipmill-romamo Bot deleted the docs/database-claims branch October 16, 2026 09:57
@shipmill-romamo shipmill-romamo Bot added this to the 0.7.0 milestone Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant