mirror of
https://github.com/stack-auth/stack.git
synced 2026-06-13 21:01:21 +08:00
57ff5d3ce9
Some checks failed
all-good: Did all the other checks pass? / all-good (push) Has been cancelled
Ensure Prisma migrations are in sync with the schema / check_prisma_migrations (22.x) (push) Has been cancelled
DB migration compat / Check if migrations changed (push) Has been cancelled
Docker Server Build and Push / Docker Build and Push Server (push) Has been cancelled
Docker Server Build and Run / docker (push) Has been cancelled
Runs E2E API Tests (Local Emulator) / E2E Tests (Local Emulator, Node ${{ matrix.node-version }}) (22.x) (push) Has been cancelled
Runs E2E API Tests / E2E Tests (Node ${{ matrix.node-version }}, Freestyle ${{ matrix.freestyle-mode }}) (mock, 22.x) (push) Has been cancelled
Runs E2E API Tests / E2E Tests (Node ${{ matrix.node-version }}, Freestyle ${{ matrix.freestyle-mode }}) (prod, 22.x) (push) Has been cancelled
Runs E2E API Tests with custom port prefix / build (22.x) (push) Has been cancelled
Runs E2E Fallback Tests / E2E Fallback Tests (Node ${{ matrix.node-version }}) (22.x) (push) Has been cancelled
Lint & build / lint_and_build (24) (push) Has been cancelled
TOC Generator / TOC Generator (push) Has been cancelled
DB migration compat / Back-compat — Current branch migrations with ${{ needs.check-migrations-changed.outputs.base_branch }} branch code (push) Has been cancelled
DB migration compat / Forward-compat — Current branch code with ${{ needs.check-migrations-changed.outputs.base_branch }} branch migrations (push) Has been cancelled
DB migration compat / No migration changes (skipped) (push) Has been cancelled
## Summary **Stacked on [#1475](https://github.com/hexclave/stack-auth/pull/1475)** (`cl/hexclave-pr1`, the invisible compatibility layer). Diff vs that base = the actual PR 2 code. This is **PR 2 of the Stack Auth → Hexclave rebrand: the visible flip**. Old wire identifiers (cookies, request/response headers, Bearer prefix, JWT issuers, MCP tool name) keep working indefinitely via PR 1's dual-accept. This PR flips every user-visible surface — package names taught in docs, SDK class names in code examples, dashboard setup snippets, page titles, error messages, email content, CLI binary, default base URLs, GitHub repo slug, contributor guidance — to the Hexclave brand. See [`RENAME-TO-HEXCLAVE.md`](./RENAME-TO-HEXCLAVE.md) → *"PR 2: Rebrand to Hexclave (visible)"* for the full per-work-area spec. ## What's implemented (per the plan's PR 2 scope) - **SDK base URLs** flipped: `defaultBaseUrl` and `defaultAnalyticsBaseUrl` in [common.ts](packages/template/src/lib/stack-app/apps/implementations/common.ts:127) → `https://api.hexclave.com` / `https://r.hexclave.com`. PR 1's [`getHardcodedFallbackUrls`](packages/stack-shared/src/utils/urls.tsx:199) table now keys on the Hexclave domain. - **Domain inventory sweep** (16 subdomains from the plan): every `api/app/docs/discord/demo/mcp/skill/feedback/test/preview/r/api2/api.staging/idp-jwk-audience/built-with.stack-auth.com` reference in production code, docs-mintlify, examples, READMEs, and contributor guidance flipped to `*.hexclave.com`. Carve-outs: PR 1's intentional JWT issuer dual-accept table in [tokens.tsx](apps/backend/src/lib/tokens.tsx), the legacy `./docs/` folder, the `unified-docs-widget` allowlist (deliberately accepts both during DNS transition), and `url-targets.ts` hosted-component default (baked into existing customer deploys). - **`@deprecated` JSDoc** on every `Stack*` public export ([packages/template/src/lib/stack-app/index.ts](packages/template/src/lib/stack-app/index.ts) + [packages/template/src/index.ts](packages/template/src/index.ts)) — `StackClientApp`, `StackServerApp`, `StackAdminApp` + every constructor/options/JSON type, `StackHandler`, `StackProvider`, `StackTheme`, `useStackApp`, `defineStackConfig`, `StackConfig`. Hexclave\* aliases are now canonical. - **Runtime `console.warn`** ([packages/template/src/internal/deprecation-warning.ts](packages/template/src/internal/deprecation-warning.ts)) — once-per-process when the SDK is loaded from a `@stackframe/*` artifact. Detection uses the existing `STACK_COMPILE_TIME_CLIENT_PACKAGE_VERSION_SENTINEL` (rewritten at build time to e.g. `js @stackframe/stack@2.8.92` or `js @hexclave/next@1.0.0`); `@hexclave/*` mirror artifacts short-circuit the warning. - **Tier 3 data migration**: new idempotent SQL migration [`20260523000000_rename_internal_project_to_hexclave`](apps/backend/prisma/migrations/20260523000000_rename_internal_project_to_hexclave/migration.sql) — updates the internal Project `displayName` 'Stack Dashboard' → 'Hexclave Dashboard' and `description` only if both still hold the pre-rebrand defaults. Operator-renamed projects untouched, missing row no-ops, re-runs are no-ops. [`seed.ts`](apps/backend/prisma/seed.ts:87) default flipped. `getSharedEmailConfig("Stack Auth")` → `("Hexclave")`. - **Tier 4 brand strings** (mechanical sweep, ~340 files): - Page + OpenAPI titles (Hexclave API / Dashboard / REST API / Webhooks API / Documentation). OpenAPI `info.description` documents `X-Hexclave-*` headers as canonical with compat note on `X-Stack-*`. - `HexclaveAssertionError` message text ([errors.tsx:71](packages/stack-shared/src/utils/errors.tsx:71)) — "an error in Stack." → "an error in Hexclave." - Known-error message templates ([known-errors.tsx](packages/stack-shared/src/known-errors.tsx)) flipped to lead with `x-hexclave-*` + the new `docs.hexclave.com` URL; legacy `x-stack-*` mentioned as compat aliases. **25 e2e test files updated in lockstep**. - Email content: failed-emails-digest body, sendTestEmail recipient (now `sent-with-hexclave.com`), test-email-recipient default. - `CHANGELOG.md` title → "Hexclave Changelog". - `AGENTS.md` env var convention: new vars prefix `HEXCLAVE_` / `NEXT_PUBLIC_HEXCLAVE_` for Category A/B; legacy `STACK_*` explicitly noted as accepted via PR 1's dual-read. - **CLI / init wizard**: - Every dashboard setup snippet, init-stack template, and docs-mintlify page teaches `npx @hexclave/cli@latest init` (was `@stackframe/stack-cli`). [setup-page.tsx](apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/(overview)/setup-page.tsx) + [link-existing-onboarding](apps/dashboard/src/app/(main)/(protected)/(outside-dashboard)/new-project/page-client-parts/link-existing-onboarding.tsx). - [init-stack](packages/init-stack/src/index.ts:634) `STACK_*_INSTALL_PACKAGE_NAME_OVERRIDE` defaults flipped to `@hexclave/*`. - Generated `stack/client.ts` / `stack/server.ts` import from `@hexclave/next` and reference `HexclaveClientApp` / `HexclaveServerApp`. - Internal `StackAuthKeys` dashboard component renamed to `HexclaveKeys`. - **docs-mintlify rewrite** (legacy `./docs/` intentionally untouched per scoping decision): - **78 MDX files swept**. `@stackframe/{react,stack,js,tanstack-start,...}` → `@hexclave/{react,stack,js,...}` in install snippets and code blocks; `Stack*` SDK class names → `Hexclave*` in all code examples; 'Stack Auth' brand phrase → 'Hexclave'. - `openapi/{server,admin,client,webhooks}.json` titles → 'Hexclave REST API' / 'Hexclave Webhooks API'. - **Generators flipped before regeneration**: - [`packages/stack-shared/src/helpers/init-prompt.ts`](packages/stack-shared/src/helpers/init-prompt.ts), [`/ai/prompts.ts`](packages/stack-shared/src/ai/prompts.ts), [`apps/backend/src/lib/ai/prompts.ts`](apps/backend/src/lib/ai/prompts.ts), [`apps/backend/src/lib/ai/tools/create-email-{template,draft}.ts`](apps/backend/src/lib/ai/tools/create-email-template.ts), [`apps/skills/src/app/route.ts`](apps/skills/src/app/route.ts) (taught MCP tool → `ask_hexclave` with compat note; CLI binary teach → `hexclave`), [`docs-mintlify/snippets/home-prompt-island.jsx`](docs-mintlify/snippets/home-prompt-island.jsx), [`packages/template/README.md`](packages/template/README.md) + integrations/convex/component/README.md. - `generate-sdks` propagated changes to `packages/{react,stack,js}`. - **OpenAPI dual-documentation**: [`apps/backend/src/app/api/latest/route.ts`](apps/backend/src/app/api/latest/route.ts) now lists `X-Hexclave-*` headers as primary documented schemas with `X-Stack-*` duplicates marked `.optional()` (both accepted at runtime by PR 1's normalize-at-proxy shim). - **`@stackframe/emails` virtual module**: dual-aliased to `@hexclave/emails` at the bundler boundary ([email-rendering.tsx:89](apps/backend/src/lib/email-rendering.tsx:89)). Stored email templates continue to import from either name; new AI-generated templates and the system prompt teach `@hexclave/emails`. - **Tier 2 mirror-publish wiring** (new this PR, lays the groundwork for `@hexclave/*` first publish): - [`scripts/rewrite-packages-to-hexclave.ts`](scripts/rewrite-packages-to-hexclave.ts) — rewrites 9 publishable `@stackframe/*` → `@hexclave/*` `package.json` files (reads `HEXCLAVE_VERSION` env or `--version=` flag), pins cross-deps to the shared `@hexclave` version, registers `hexclave` bin alongside `stack` for `@hexclave/cli`. - [`.github/workflows/npm-publish.yaml`](.github/workflows/npm-publish.yaml) appended with rewrite-then-republish step. `pnpm publish` skips already-on-npm versions so reruns are safe. - **Sender email domain**: `noreply@stackframe.co` → `noreply@sent-with-hexclave.com` (the dedicated transactional-sender domain split per the plan, to isolate bulk deliverability from `hexclave.com` reputation); `security@` / `team@stack-auth.com` inbound mailboxes → `@hexclave.com`. - **Self-host docs**: docker network / container names in the bash examples flipped from `stack-auth` to `hexclave` (`hexclave-postgres`, `hexclave-clickhouse`, `hexclave.env`). The docker image tag `stackauth/server:latest` stays per the plan's locked decision. - **GitHub repo slug**: `hexclave/stack-auth` → `hexclave/hexclave` in every `package.json` `repository` field, README link, CHANGELOG raw-asset URL. ## Carve-outs (deliberately untouched) - **[`apps/backend/src/lib/tokens.tsx`](apps/backend/src/lib/tokens.tsx)** JWT issuer dual-accept table — PR 1 intentional infrastructure, kept indefinitely. - **Legacy `./docs/` folder** — per scoping decision (only `docs-mintlify/` rewritten). - **`unified-docs-widget` hostname allowlist** — accepts both `.hexclave.com` (canonical) and `.stack-auth.com` (transition window) for DNS rollout. - **`url-targets.ts`** hosted-domain default `.built-with-stack-auth.com` — wire identifier baked into existing customer deploys; indefinite read-fallback. - **Binary visual assets** (logos, favicons, OG images, README screenshots) — out of scope for this PR. Need design work; tracked separately. ## Verification - **`pnpm typecheck`** on `packages/{template,stack-shared,react,stack,js}` + `apps/dashboard`: **all green**. The remaining backend / e-commerce-demo typecheck errors are pre-existing (Prisma codegen output + `./generated/api-versions.json` not present in fresh worktrees without `pnpm run codegen-prisma` + a live DB) and unrelated to this diff. - **`pnpm lint`** on the same 6 packages: all green. - **Final grep** for residual `Stack Auth` / `stack-auth.com` / `@stackframe/stack-cli@latest` references: zero outside the intentional carve-outs above. - **25 e2e test files updated in lockstep** with the known-error message changes (asserted strings flipped to match the new x-hexclave-* + compat-note messages). ## Deploy blockers (ops sequencing before this rebrand goes live) This PR is code-complete, but the rebrand's visible surfaces (SDK default URLs, dashboard links, npm READMEs, REST error messages, runtime deprecation warning) all point at `*.hexclave.com` / `@hexclave/*` resources that don't exist yet. None of these are fixable from a PR — they're ops/registrar/npm work that has to be sequenced before merging this to a release tag. Suggested ordering, hardest blockers first: ### Tier 1 — required before customer-facing deploy (everything below this line *will visibly break customers on day 1* if skipped) 1. **DNS + TLS for `api.hexclave.com` + `api1./api2.hexclave.com`** → must point at the same backend that serves `api.stack-auth.com` (or a backend that mirrors PR 1's dual-accept). The SDK's new `defaultBaseUrl` is `https://api.hexclave.com`; every customer that relied on the old default and upgrades to a post-PR2 SDK build sends API requests here. Until this resolves, every default-config customer's API call NXDOMAINs. 2. **DNS for `app.hexclave.com`** → the dashboard. Referenced in the SDK's default-error messages ("Please create a project on the Hexclave dashboard at https://app.hexclave.com"), the init-stack flow's `wizard-congrats` redirect, and the OAuth dashboard handoff. 3. **DNS for `docs.hexclave.com`** + Mintlify deploy → the SDK runtime deprecation warning (`https://docs.hexclave.com/migration`), every README, every "Learn more" link in the dashboard, and every REST API error body (`/api/overview#authentication`) points here. The MDX is in this PR; the docs build target needs DNS. 4. **DNS for `mcp.hexclave.com`** → the MCP server endpoint that every taught agent integration (`claude mcp add ...`, `cursor`, `codex`, `vscode`) registers. Until this resolves, every `npx @hexclave/cli@latest init` MCP-registration step fails. 5. **Reserve the `@hexclave` npm scope + set repo variable `HEXCLAVE_VERSION`** → the mirror-publish step in `.github/workflows/npm-publish.yaml` is gated on this variable. Without it, the entire taught onboarding command `npx @hexclave/cli@latest init` 404s from the npm registry, *and* every README that says "install `@hexclave/next`" leads to install failure. Pick the initial version intentionally (`1.0.0` or aligned to `@stackframe/stack`); don't accept a silent default. ### Tier 2 — required before announcing the rebrand publicly (lookalike or low-traffic surfaces, but visibly broken) 6. **DNS for `r.hexclave.com`** → the analytics beacon `defaultAnalyticsBaseUrl`. Silent failure if missing (analytics drops), but should land alongside Tier 1. 7. **Register `sent-with-hexclave.com` + full email auth (SPF / DKIM / DMARC)** → the new default sender domain for shared-sender transactional emails. Without it the dashboard "send test email" path emits bounces, and shared-sender flows (`getSharedEmailConfig("Hexclave")`) deliver to spam at best. 8. **MX + SPF / DMARC for `hexclave.com`** → `team@hexclave.com` and `security@hexclave.com` mailboxes. The security disclosure mailbox is referenced in [`.github/SECURITY.md`](.github/SECURITY.md); `team@hexclave.com` is the actual recipient of internal feedback emails sent at runtime by [`apps/backend/src/lib/internal-feedback-emails.tsx`](apps/backend/src/lib/internal-feedback-emails.tsx). Today, every runtime feedback email bounces. 9. **DNS for `skill.hexclave.com`** → the canonical AI-agent skill fetch URL (the agent bootstrap pivot). Without it, the entire "agent downloads `SKILL.md` from a known URL" flow taught in [`packages/stack-shared/src/helpers/init-prompt.ts`](packages/stack-shared/src/helpers/init-prompt.ts) fails. 10. **Create `github.com/hexclave/hexclave` as a public repo** (even as a redirect to `hexclave/stack-auth`) **OR** rewrite every `package.json` `"repository"` field + dashboard footer "view on GitHub" link to point at `hexclave/stack-auth` (which already exists). Currently every npm package page's "Repository" link is dead, and the dashboard's GitHub button + dev-tool repo link are dead. ### Tier 3 — broken but low-visibility / low-traffic 11. **DNS for `discord.hexclave.com`** → Discord invite redirect, used in every README's chip and the dashboard footer. 12. **DNS for `demo.hexclave.com`** → "✨ Demo" badge in every npm package README. Broken-image badge on the package page. 13. **DNS + TLS for `built-with-hexclave.com`** → optional hosted-handler domain (the default reverted to `.built-with-stack-auth.com` in this PR's carve-outs, so this only matters for projects that manually flip). ## Other follow-ups (not deploy-blocking) - **E2E snapshot regen across the full suite** for the dual-emitted `x-hexclave-*` response headers (PR 1 follow-up; `vitest -u` in CI absorbs). - **Binary visual assets** — logos, favicons, OG images, README screenshots; need design pass. - **Backend OpenAPI fumadocs regen** in CI flow — the JSON files in `docs-mintlify/openapi/` are committed but regen runs in CI. Verify the workflow that does this still works against the post-PR2 source. - **Backend typecheck infra debt** — needs `codegen-prisma` + `codegen-route-info` to clear; pre-existing, unaffected by this PR. ## Test plan - [ ] CI runs full e2e suite (with `vitest -u` to absorb residual snapshot deltas, then committed back). - [ ] Spot-check: new `@hexclave/cli init` (once published) generates `hexclave.config.ts` and works against a fresh project. - [ ] Spot-check: existing customer with `@stackframe/stack` import sees the once-per-process `console.warn` recommending `@hexclave/next` on SDK init. - [ ] Manual: dashboard setup page renders the `npx @hexclave/cli@latest init` snippet and the `x-hexclave-publishable-client-key` API header in the curl example. - [ ] Manual: a fresh `pnpm run prisma migrate` against a clean DB sets the internal project displayName to 'Hexclave Dashboard'. --------- Co-authored-by: Konstantin Wohlwend <n2d4xc@gmail.com>
448 lines
14 KiB
HTML
448 lines
14 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>Hexclave Dev Launchpad</title>
|
|
<script src="./env-config.js"></script>
|
|
<style>
|
|
body {
|
|
font-family: Arial, sans-serif;
|
|
background-color: #e0f0e0;
|
|
padding-left: 16px;
|
|
padding-right: 16px;
|
|
}
|
|
|
|
.apps-container {
|
|
display: flex;
|
|
flex-direction: row;
|
|
flex-wrap: wrap;
|
|
gap: 16px;
|
|
}
|
|
|
|
.apps-container > a {
|
|
border: 1px solid #8888;
|
|
background-color: #fff;
|
|
padding: 0px 4px 8px 4px;
|
|
width: 120px;
|
|
|
|
text-decoration: none;
|
|
|
|
display: flex;
|
|
flex-direction: column;
|
|
align-items: center;
|
|
gap: 12px;
|
|
|
|
position: relative;
|
|
}
|
|
|
|
.apps-container > a.important {
|
|
background-color: #fee;
|
|
}
|
|
|
|
.apps-container > a.unimportant {
|
|
opacity: 0.2;
|
|
}
|
|
|
|
.apps-container > a.unimportant:hover {
|
|
opacity: 0.5;
|
|
}
|
|
|
|
.apps-container > a:hover {
|
|
border-color: #888;
|
|
transition: opacity 0.1s ease-in-out;
|
|
}
|
|
|
|
.apps-container > a > div > img {
|
|
height: 68px;
|
|
}
|
|
|
|
.apps-container > a > .description {
|
|
text-align: center;
|
|
font-size: 12px;
|
|
color: #888;
|
|
}
|
|
|
|
.apps-container > a > .port {
|
|
padding-right: 0.5px;
|
|
padding-top: 1px;
|
|
align-self: flex-end;
|
|
font-size: 12px;
|
|
color: #888;
|
|
}
|
|
|
|
.apps-container > a > .hover-description {
|
|
display: none;
|
|
position: absolute;
|
|
top: 100%;
|
|
left: -1px;
|
|
pointer-events: none;
|
|
z-index: 1000;
|
|
white-space: pre;
|
|
background-color: #ffc;
|
|
border: 1px solid #888;
|
|
padding: 2px;
|
|
color: #0008;
|
|
font-size: 12px;
|
|
}
|
|
|
|
.apps-container > a:hover > .hover-description {
|
|
display: block;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1>Hexclave Dev Launchpad</h1>
|
|
<div class="apps-container"></div>
|
|
<hr />
|
|
<div class="apps-container"></div>
|
|
<hr />
|
|
<div class="apps-container"></div>
|
|
|
|
<h2 style="margin-top: 64px;">Background services</h2>
|
|
<ul class="background-services"></ul>
|
|
<noscript>
|
|
This page requires JavaScript.
|
|
</noscript>
|
|
<script>
|
|
const derivePrefixFromLocation = () => {
|
|
const port = window.location.port;
|
|
if (!port || port.length < 2) return "81";
|
|
return port.slice(0, -2);
|
|
};
|
|
const stackPortPrefix = window.NEXT_PUBLIC_HEXCLAVE_PORT_PREFIX || derivePrefixFromLocation();
|
|
window.NEXT_PUBLIC_HEXCLAVE_PORT_PREFIX = stackPortPrefix;
|
|
const withPrefix = (suffix) => `${stackPortPrefix}${suffix}`;
|
|
|
|
// Depending on the port prefix, set the color to light grey (port 91), light purple (port 92), papyrus yellow (port 93), or default otherwise
|
|
const color = {
|
|
"91": "#f8f8f8",
|
|
"92": "#fff8e0",
|
|
"93": "#e0e0ff",
|
|
}[stackPortPrefix] || undefined;
|
|
document.body.style.backgroundColor = color;
|
|
|
|
const backgroundServices = [
|
|
{ suffix: "28", label: "PostgreSQL" },
|
|
{ suffix: "34", label: "PostgreSQL Replica (with replication lag)" },
|
|
{ suffix: "29", label: "Inbucket SMTP" },
|
|
{ suffix: "30", label: "Inbucket POP3" },
|
|
{ suffix: "31", label: "OTel collector" },
|
|
{ suffix: "21", label: "S3 mock" },
|
|
{ suffix: "22", label: "Freestyle mock" },
|
|
{ suffix: "24", label: "LocalStack Gateway (AWS mock)" },
|
|
{ suffix: "25", label: "QStash mock" },
|
|
{ suffix: "33", label: "ClickHouse native interface" },
|
|
{ suffix: "39", label: "SpacetimeDB (MCP call log)" },
|
|
{ range: ["50", "99"], label: "Reserved for LocalStack (external services)" },
|
|
];
|
|
|
|
const backgroundList = document.querySelector(".background-services");
|
|
backgroundList.innerHTML = backgroundServices.map((service) => {
|
|
const portText = service.range
|
|
? `${withPrefix(service.range[0])}-${withPrefix(service.range[1])}`
|
|
: withPrefix(service.suffix);
|
|
return `<li>${portText}: ${service.label}</li>`;
|
|
}).join("");
|
|
|
|
const apps = [
|
|
{
|
|
name: "Dashboard",
|
|
portSuffix: "01",
|
|
description: [
|
|
"Src: ./apps/dashboard",
|
|
"Prod: https://app.hexclave.com",
|
|
],
|
|
img: "https://www.svgrepo.com/show/507260/dashboard.svg",
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Backend",
|
|
portSuffix: "02",
|
|
description: [
|
|
"Src: ./apps/backend",
|
|
"Prod: https://api.hexclave.com",
|
|
],
|
|
img: "https://www.svgrepo.com/show/340122/datastore.svg",
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "MCP",
|
|
portSuffix: "44",
|
|
description: [
|
|
"Src: ./apps/mcp",
|
|
"Prod: https://mcp.hexclave.com/mcp",
|
|
],
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Skills",
|
|
portSuffix: "45",
|
|
description: [
|
|
"Src: ./apps/skills",
|
|
"Prod: https://skill.hexclave.com",
|
|
],
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Demo app",
|
|
portSuffix: "03",
|
|
description: [
|
|
"Src: ./examples/demo",
|
|
"Prod: https://demo.hexclave.com",
|
|
],
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "TanStack Start demo",
|
|
portSuffix: "43",
|
|
description: [
|
|
"Src: ./examples/tanstack-start-demo",
|
|
"Alpha SDK integration demo",
|
|
],
|
|
img: "https://tanstack.com/favicon.ico",
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Docs",
|
|
portSuffix: "26",
|
|
description: [
|
|
"Src: ./docs",
|
|
"Prod: https://docs.hexclave.com",
|
|
],
|
|
img: "https://www.svgrepo.com/show/448400/docs.svg",
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Mintlify docs",
|
|
portSuffix: "04",
|
|
description: [
|
|
"Src: ./docs-mintlify",
|
|
],
|
|
img: "https://www.svgrepo.com/show/448400/docs.svg",
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Hosted Components",
|
|
portSuffix: "09",
|
|
description: [
|
|
"Src: ./apps/hosted-components",
|
|
],
|
|
importance: 2,
|
|
},
|
|
{
|
|
name: "Inbucket",
|
|
portSuffix: "05",
|
|
img: "https://www.svgrepo.com/show/533176/at-sign.svg",
|
|
importance: 1,
|
|
description: [
|
|
"Email mock",
|
|
],
|
|
},
|
|
{
|
|
name: "Prisma Studio",
|
|
portSuffix: "06",
|
|
importance: 1,
|
|
img: "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS95TdAw63YPAPcUpvRl4imIf-VJ1sGHnEvbw&s",
|
|
description: [
|
|
"Database interface",
|
|
],
|
|
},
|
|
{
|
|
name: "Jaeger UI (OTel)",
|
|
portSuffix: "07",
|
|
description: [
|
|
"Performance & tracing",
|
|
],
|
|
importance: 1,
|
|
img: "https://www.jaegertracing.io/img/jaeger-icon-reverse-color.svg",
|
|
},
|
|
{
|
|
name: "examples/docs-examples",
|
|
portSuffix: "08",
|
|
description: [
|
|
"Src: ./examples/docs-examples",
|
|
],
|
|
},
|
|
{
|
|
name: "examples/cjs-test",
|
|
portSuffix: "10",
|
|
description: [
|
|
"Src: ./examples/cjs-test",
|
|
],
|
|
},
|
|
{
|
|
name: "examples/e-commerce",
|
|
portSuffix: "11",
|
|
description: [
|
|
"Src: ./examples/e-commerce",
|
|
],
|
|
},
|
|
{
|
|
name: "examples/middleware",
|
|
portSuffix: "12",
|
|
description: [
|
|
"Src: ./examples/middleware",
|
|
],
|
|
},
|
|
{
|
|
name: "Svix server",
|
|
portSuffix: "13",
|
|
importance: 1,
|
|
img: "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyBpZD0iTGF5ZXJfMiIgZGF0YS1uYW1lPSJMYXllciAyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgdmlld0JveD0iODQuOSA4NC45IDM0NyAzNDciPgogIDxkZWZzPgogICAgPHN0eWxlPgogICAgICAuY2xzLTEgewogICAgICAgIGZpbGw6ICNmZmY7CiAgICAgIH0KCiAgICAgIC5jbHMtMSwgLmNscy0yIHsKICAgICAgICBzdHJva2Utd2lkdGg6IDBweDsKICAgICAgfQoKICAgICAgLmNscy0yIHsKICAgICAgICBmaWxsOiAjMmM3MGZmOwogICAgICB9CiAgICA8L3N0eWxlPgogIDwvZGVmcz4KICA8ZyBpZD0iTGF5ZXJfMS0yIiBkYXRhLW5hbWU9IkxheWVyIDEtMiI+CiAgICA8Y2lyY2xlIGNsYXNzPSJjbHMtMSIgY3g9IjI1OC40IiBjeT0iMjU4LjQiIHI9IjE3My41Ii8+CiAgICA8Zz4KICAgICAgPHBhdGggY2xhc3M9ImNscy0yIiBkPSJNMzYwLjgsMjMyLjljLTI4LjgtMS40LTU1LjctMTcuMi02OC4yLTQ1LTUuNS0xMi4zLTE3LjgtMjAuNC0zMS4zLTIwLjgtMjguNi0uOC00Ni43LDM1LjEtMjguNyw1Ny42LDYuMiw3LjgsMTUuNCwxMi4xLDI3LjUsMTIuOWgwYzIzLjQsMS43LDQzLjUsMTEuOCw1Ni44LDI4LjUsMjQuNCwzMC43LDIwLjksNzcuMS03LjQsMTA0LTM0LjEsMzIuNS05MS4xLDI1LjgtMTE3LjEtMTMuMi0yLjMtMy41LTQuMy03LjEtNi4xLTEwLjktNS41LTEyLjMtMTcuOC0yMC40LTMxLjMtMjAuOC0xMy45LS40LTI3LDQuOS0zNS4zLDEzLjgsMjcuMyw0Ni45LDc3LjcsNzguNywxMzUuOSw3OS43LDg4LjYsMS41LDE2MS43LTY5LDE2My4yLTE1Ny42LjMtMTQuOS0xLjYtMjkuNC01LjEtNDMuMi43LDIuOS0yMi4zLDEwLjktMjQuOCwxMS42LTkuMiwyLjctMTguNywzLjctMjgsMy4zaDBaIi8+CiAgICAgIDxwYXRoIGNsYXNzPSJjbHMtMiIgZD0iTTE1NiwyODMuNmMyOS40LjcsNTYuMSwxOC41LDY4LjIsNDUuMyw1LjUsMTIuMywxNy44LDIwLjQsMzEuMywyMC44LDkuNC4zLDE4LjMtMy4yLDI1LjItOS43LDEyLjgtMTIuMSwxNC41LTM0LjEsMy41LTQ4LTYuMi03LjgtMTUuNC0xMi4xLTI3LjUtMTIuOWgwYy0yMy40LTEuNy00My41LTExLjgtNTYuOC0yOC41LTI5LjYtMzcuMi0xNy05Mi41LDIzLjctMTE1LjQsMTEuOC02LjYsMjUuMi0xMC4yLDM4LjctOS44LDI5LjQuNyw1Ni4xLDE4LjUsNjguMiw0NS4zLDUuNSwxMi4zLDE3LjgsMjAuNCwzMS4zLDIwLjgsMTQsLjQsMjctNC45LDM1LjMtMTMuOC0yNy4zLTQ2LjktNzcuNy03OC43LTEzNS45LTc5LjgtODguNi0xLjUtMTYxLjYsNjkuMS0xNjMuMiwxNTcuNi0uMywxNC45LDEuNiwyOS40LDUuMiw0My4yLDE0LjktMTAuMSwzMy4zLTE1LjYsNTIuOS0xNS4yaDBaIi8+CiAgICA8L2c+CiAgPC9nPgo8L3N2Zz4=",
|
|
description: [
|
|
"Webhooks",
|
|
],
|
|
},
|
|
{
|
|
name: "OAuth mock server",
|
|
portSuffix: "14",
|
|
description: [
|
|
"Src: ./apps/mock-oauth-server",
|
|
],
|
|
},
|
|
{
|
|
name: "examples/supabase",
|
|
portSuffix: "15",
|
|
description: [
|
|
"Src: ./examples/supabase",
|
|
],
|
|
},
|
|
{
|
|
name: "PgHero",
|
|
portSuffix: "16",
|
|
description: [
|
|
"For database performance analysis",
|
|
],
|
|
importance: 1,
|
|
img: "https://pghero.dokkuapp.com/assets/pghero-88a0d052.png",
|
|
},
|
|
{
|
|
name: "PgHero (Replica)",
|
|
portSuffix: "35",
|
|
description: [
|
|
"For replica database performance analysis",
|
|
],
|
|
importance: 1,
|
|
img: "https://pghero.dokkuapp.com/assets/pghero-88a0d052.png",
|
|
},
|
|
{
|
|
name: "PgAdmin",
|
|
portSuffix: "17",
|
|
description: [
|
|
"For database administration",
|
|
],
|
|
importance: 1,
|
|
img: "https://www.w3schools.com/postgresql/screenshot_postgresql_pgadmin4_6.png",
|
|
},
|
|
{
|
|
name: "Supabase Studio",
|
|
portSuffix: "18",
|
|
path: "/project/default/editor",
|
|
description: [
|
|
"For database administration",
|
|
],
|
|
importance: 1,
|
|
img: "https://cdn.prod.website-files.com/655b60964be1a1b36c746790/655b60964be1a1b36c746d41_646dfce3b9c4849f6e401bff_supabase-logo-icon_1.png",
|
|
},
|
|
{
|
|
name: "Drizzle Gateway",
|
|
portSuffix: "33",
|
|
description: [
|
|
"Manage Drizzle configs",
|
|
],
|
|
importance: 1,
|
|
},
|
|
{
|
|
name: "WAL Info",
|
|
portSuffix: "38",
|
|
description: [
|
|
"Replication & WAL monitoring",
|
|
"Tracks primary/replica LSN positions",
|
|
"Decodes WAL to SQL statements",
|
|
],
|
|
importance: 1,
|
|
img: "https://www.svgrepo.com/show/374002/replication.svg",
|
|
},
|
|
{
|
|
name: "Internal Tool",
|
|
portSuffix: "41",
|
|
description: [
|
|
"Src: ./apps/internal-tool",
|
|
"MCP call review tool",
|
|
],
|
|
importance: 1,
|
|
},
|
|
{
|
|
name: "Bulldozer Studio",
|
|
portSuffix: "40",
|
|
description: [
|
|
"Bulldozer table graph and editor",
|
|
"Includes raw storage debug browser",
|
|
],
|
|
importance: 1,
|
|
img: "https://www.svgrepo.com/show/349299/database.svg",
|
|
},
|
|
{
|
|
name: "JS example",
|
|
portSuffix: "19",
|
|
description: [
|
|
"JavaScript example",
|
|
],
|
|
},
|
|
{
|
|
name: "React example",
|
|
portSuffix: "20",
|
|
description: [
|
|
"React example",
|
|
],
|
|
},
|
|
{
|
|
name: "ClickHouse HTTP",
|
|
portSuffix: "36",
|
|
description: [
|
|
"ClickHouse",
|
|
],
|
|
importance: 1,
|
|
img: "https://thumbs.bfldr.com/at/qkjfv3nvsv4rbwn94zmtb4t/v/1197417003?expiry=1764357242&fit=bounds&height=800&sig=NjEwNzA0OThjZmJiZDQzZmUwNjIyY2UxYzZiNGYxNmQ3NjJiYjc0OA%3D%3D&width=1100",
|
|
},
|
|
{
|
|
name: "Convex example",
|
|
portSuffix: "27",
|
|
importance: 0,
|
|
description: [
|
|
"Convex example",
|
|
],
|
|
},
|
|
{
|
|
name: "Lovable React 18 example",
|
|
portSuffix: "32",
|
|
importance: 0,
|
|
description: [
|
|
"Lovable React 18 example",
|
|
],
|
|
},
|
|
];
|
|
|
|
const appsContainers = document.querySelectorAll(".apps-container");
|
|
for (let i = 0; i < appsContainers.length; i++) {
|
|
const appContainer = appsContainers[i];
|
|
const importance = appsContainers.length - i - 1;
|
|
for (const app of apps) {
|
|
if ((app.importance ?? 0) === importance) {
|
|
// TODO escape HTML
|
|
appContainer.innerHTML += `
|
|
<a href="http://${`${stackPortPrefix}` === "81" ? "" : `p${stackPortPrefix}.`}localhost:${withPrefix(app.portSuffix)}${app.path ?? ""}" target="_blank" rel="noopener noreferrer" class="${app.importance === 2 ? "important" : app.importance === 1 ? "" : "unimportant"}">
|
|
<div class="port">:${withPrefix(app.portSuffix)}</div>
|
|
<div>
|
|
<img src=${app.img || `//localhost:${withPrefix(app.portSuffix)}/favicon.ico`} />
|
|
</div>
|
|
<span class="description">${app.name}</span>
|
|
${app.description ? `<div class="hover-description">${app.description.join("\n")}</div>` : ""}
|
|
</a>
|
|
`;
|
|
}
|
|
}
|
|
}
|
|
</script>
|
|
</body>
|
|
</html>
|