Skip to content

Add Shortwave link-shortener example - #425

Merged
sdairs merged 1 commit into
mainfrom
codex/add-shortwave-example
Sep 16, 2026
Merged

sdairs merged 1 commit into
mainfrom
codex/add-shortwave-example

Conversation

@sdairs

@sdairs sdairs commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator

Adds Shortwave under applications/shortwave: a link-shortener application using ClickHouse Managed Postgres for application data and redirects, ClickPipes for current link metadata, and ClickHouse for click analytics. The TanStack Start/React app uses Click UI and Clerk and runs on Cloudflare Workers.

Includes account-owned links, tags and folders, UTM templates, QR codes, operator-owned custom domains, and analytics with a durable click outbox and retry deduplication. The example includes explicit CLI/SQL deployment instructions, operations guidance, and a fresh-deployment acceptance checklist.

This is a snapshot import in one new commit on top of main. No commits from the source repository's development history are imported. Private deployment state, credentials, environment files, screenshots, dependencies, and build outputs are excluded. The root README links to the example, its clone instructions use the destination path, and a root GitHub Actions workflow runs checks only for Shortwave changes.

Validation

Performed in a clean directory in an isolated Linux arm64 VM with Node 22.23.2 and the locked dependencies, without deployment credentials:

  • npm ci — passed.
  • npm test — 39 passed, 3 live integration suites skipped, 0 failures.
  • npm run types:workers and npm run typecheck — passed.
  • npm run build:workers — passed.
  • npx wrangler deploy --dry-run — passed; no deployment performed.
  • npm audit — 0 vulnerabilities.
  • git diff --check, 83 local documentation links/anchors, and public-file/private-value review — passed.

The build reports large client chunks and missing runtime secrets in this credential-free checkout. Dependency installation also reports existing React peer-dependency warnings.

Live Cloud integration, browser acceptance, production Clerk sessions, and the complete fresh-deployment/redeploy/cleanup rehearsal were not run for this import. The example's docs/v1-readiness.md records the remaining deployment acceptance requirements; the checks above do not establish hosted readiness.

@sdairs
sdairs force-pushed the codex/add-shortwave-example branch 2 times, most recently from c414810 to 99d05c6 Compare September 16, 2026 10:49
@sdairs
sdairs force-pushed the codex/add-shortwave-example branch from 99d05c6 to b622fef Compare September 16, 2026 11:05
@sdairs
sdairs merged commit 11dc85f into main Sep 16, 2026
1 check passed
@sdairs
sdairs deleted the codex/add-shortwave-example branch September 16, 2026 11:06
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