Samebase

Start a web app in your own GitHub and Convex accounts, and see what it deployed.

A Samebase app is a GitHub repository whose Actions deploy it with Alchemy to
a Convex project in your team. Samebase reads the Alchemy state and shows each app's URL, deployed
commit, checks, and pull request previews. Your code and infrastructure stay in your accounts.
Deleting your Samebase account does not stop your apps.

• samebase.com: the dashboard. Create an app or connect a repository.
• samebase/base: the starter. One secret, one push, Google
  sign-in included, no Samebase account needed.
• Agent plugin for Codex and Claude Code, and the
  MCP action catalog. Agents create, connect, and read apps; they
  edit code with their own tools.

Open source from this repository

Package	What it is
@samebase/identity-broker	An OpenID Provider on Convex. One Google and GitHub registration signs users in to every app, preview, and dev checkout. Run one from the identity-hub template.
@samebase/alchemy-convex	Convex for Alchemy v2: projects, deployments, environment variables, the push, state in your own Convex team, and the IdentityHub.Client resource.
samebase/plugin	The agent plugin, exported to samebase/plugin.
apps/identity-hub	samebase.com's own hub at auth.samebase.com. The public hub, id.samebase.com, runs the template unchanged.

Related repositories: convex-hosting serves an app's
files from its Convex deployment; samebase.com and every app from the starter use it.

The service

apps/samebase is the dashboard, the MCP server, the provider integrations, and
the Convex backend. TypeScript, React, TanStack Start, Convex, Tailwind CSS, Base UI, and shadcn/ui.
Vite+ runs the build, lint, format, and test tasks in a pnpm workspace.

What it does:

• Creates a GitHub repository from the starter. Its first push deploys it, with Google sign-in
  through the identity hub.
• Connects existing repositories. A repository whose Alchemy stack keeps its state in the team's
  Convex store shows that stack, including a monorepo's stacks grouped by path.
• Shows production URLs, deployed commits, checks, and the preview of each pull request.

Repair lives in the repository: the GitHub Actions log, Alchemy, and your agent. Samebase has no
built-in AI chat.

Also here: packages/git-editor and packages/sidebars
(editor and layout components), packages/sure and
packages/dependent (validation and TypeScript utilities),
apps/remotion-studio and
apps/identity-broker-explainer (video and animation sources),
and specs, docs, research, and archive.

Work on the source

Read Contributing for the toolchain and checks. Running the full service needs
maintainer configuration; a fresh clone is not yet a self-hosting setup. The
development runbook covers local setup, deployment, and sign-in, and
repository exports how packages and templates reach their public
repositories.

Bugs and feature requests: GitHub Issues. Private
vulnerability reports: SECURITY.md.

License

The Samebase app is FSL-1.1-ALv2: any use except a competing commercial service, and each
version becomes Apache-2.0 two years after its release. The packages and templates above are
Apache-2.0 or MIT. The video workbench and its recordings are all rights reserved. See
LICENSING.md for the folder-by-folder terms.