Skip to content

Simplify Neon HTTP connection guidance #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
williamjblair merged 1 commit into from
Aug 27, 2026
Merged

Simplify Neon HTTP connection guidance #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions apps/problems/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,11 +96,15 @@ build therefore obtains fresh least-privilege database URLs from Neon instead
of copying production credentials:

```bash
VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --pooled --no-color)" \
VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --pooled --no-color)" \
VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --no-color)" \
VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --no-color)" \
bun run --filter @vela/problems build
```

Problems uses the Neon serverless HTTP driver, not a long-lived TCP client.
Use direct Neon hostnames here; a pooled hostname adds no connection-pooling
benefit to the HTTP transport.

## Develop

From the repository root:
Expand All @@ -110,8 +114,8 @@ bun install --frozen-lockfile
PORT=4322 HOST=localhost bun run dev:problems # example; match the staging callback
bun run --filter @vela/problems typecheck
bun run --filter @vela/problems test
VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --pooled --no-color)" \
VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --pooled --no-color)" \
VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --no-color)" \
VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --no-color)" \
bun run --filter @vela/problems build
bun run check:design-system
```
Expand Down
6 changes: 6 additions & 0 deletions docs/performance/2026-08-13-problems-latency-and-architecture.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,12 @@ one explicit shared preview environment rather than a misleading claim of
per-PR branching. If Git previews are enabled later, replace it with automatic
branch-per-preview provisioning for both runtime credentials together.

**2026-08-27 correction.** The live Vercel project now has database variables
only in the Production environment. No Preview-scoped database variable or
Git-preview binding remains. The persistent Neon `vercel-preview` branch is
therefore retained only pending deletion approval, not as current runtime
infrastructure.

## Package and dependency disposition

- Keep `@vela/projection-data` as the only scientific projection reader and `@vela/activity-data` as the only hosted write surface.
Expand Down