authorgravatar for me@t3.ggTheo Browne <me@t3.gg> 2026-08-07 02:53:19-04:00
committergravatar for noreply@github.comGitHub <noreply@github.com> 2026-08-06 23:53:19-07:00
log4a07c1ca9d9033ef35161a1ffbea44d0418ca2bf
treea501e589667dffe50eef9ee5a9456fb0f9d3fabc
parentcf5c9948c895e120965165b7b2b643ca275c5315
signature Signed by PGP key B5690EEEBB952194

docs: ship production T3 Connect public config in .env.example (#5573)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

2 files changed, 22 insertions(+), 11 deletions(-)

.env.example+12-9
...@@ -1,12 +1,14 @@...@@ -1,12 +1,14 @@
1# Optional: T3 Connect source builds1# Optional: T3 Connect source builds
2# Leave these unset to disable optional T3 Connect features in local source builds.2# `cp .env.example .env` enables T3 Connect against the production deployment.
3# Release builds inject their public values at build time. Do not add server-side3# These are the same public identifiers baked into official release builds, not
4# secrets to this file.4# secrets. Remove or comment them out to build with cloud features disabled.
5# Do not add server-side secrets to this file.
56
6# Get these from the Clerk Dashboard under API keys, JWT templates, and OAuth applications.7# Production Clerk instance. To use your own, get these from the Clerk Dashboard
7# T3CODE_CLERK_PUBLISHABLE_KEY=pk_test_...8# under API keys, JWT templates, and OAuth applications.
8# T3CODE_CLERK_JWT_TEMPLATE=t3-relay9T3CODE_CLERK_PUBLISHABLE_KEY=pk_live_Y2xlcmsudDMuY29kZXMk
9# T3CODE_CLERK_CLI_OAUTH_CLIENT_ID=oauthapp_...10T3CODE_CLERK_JWT_TEMPLATE=t3-relay
11T3CODE_CLERK_CLI_OAUTH_CLIENT_ID=hzxSgY2cH10sDU2r
1012
11# Optional: signed macOS passkey builds. The RP domain defaults to the Frontend API13# Optional: signed macOS passkey builds. The RP domain defaults to the Frontend API
12# hostname encoded in T3CODE_CLERK_PUBLISHABLE_KEY. Set the override only when Clerk14# hostname encoded in T3CODE_CLERK_PUBLISHABLE_KEY. Set the override only when Clerk
...@@ -15,8 +17,9 @@...@@ -15,8 +17,9 @@
15# T3CODE_MACOS_PROVISIONING_PROFILE=/absolute/path/to/t3code.provisionprofile17# T3CODE_MACOS_PROVISIONING_PROFILE=/absolute/path/to/t3code.provisionprofile
16# T3CODE_CLERK_PASSKEY_RP_DOMAINS=example.clerk.accounts.dev,clerk.example.com18# T3CODE_CLERK_PASSKEY_RP_DOMAINS=example.clerk.accounts.dev,clerk.example.com
1719
18# Get this from your relay deployment. `infra/relay` deploys update it automatically.20# Production relay. For a self-hosted relay, `infra/relay` deploys update it
19# T3CODE_RELAY_URL=https://relay.example.com21# automatically.
22T3CODE_RELAY_URL=https://relay.t3.codes
2023
21# Optional: hosted app origin used by the CLI's out-of-band OAuth flow.24# Optional: hosted app origin used by the CLI's out-of-band OAuth flow.
22# Defaults to https://app.t3.codes; override to test against a staging deployment.25# Defaults to https://app.t3.codes; override to test against a staging deployment.
docs/internals/t3-connect.md+10-2
...@@ -14,8 +14,16 @@ For the wider system diagram, see...@@ -14,8 +14,16 @@ For the wider system diagram, see
1414
15## Application Keys15## Application Keys
1616
17T3 Connect is disabled in a fresh clone. To enable it for source builds, add a repository-root `.env`17T3 Connect is disabled in a fresh clone. To enable it for source builds against the production
18or `.env.local` file:18deployment, copy the repository-root example file:
19
20```sh
21cp .env.example .env
22```
23
24`.env.example` carries the production public identifiers (the same values baked into official
25release builds). To target a different Clerk application or relay, set the values yourself in a
26repository-root `.env` or `.env.local` file:
1927
20```dotenv28```dotenv
21T3CODE_CLERK_PUBLISHABLE_KEY=<publishable key>29T3CODE_CLERK_PUBLISHABLE_KEY=<publishable key>