Skip to content

Commit 744d42d

Browse files
cevhericlaude
andcommitted
docs: reconcile spec/plan + code comment with the kubernetes category
Second Copilot review flagged that the design spec, implementation plan, and the DeployTarget.github comment still described the original 4-category model (stars 'oss-paas only') after the kubernetes category was added. - deploy-targets.ts: corrected the github-field comment to 'open-source platforms: oss-paas + kubernetes' (live code — must be accurate). - spec + plan: added dated post-implementation amendment notes documenting the divergences (5 categories, stars on both oss-paas + kubernetes, Koyeb/Render deploy links) rather than rewriting the historical design record. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 49c1d78 commit 744d42d

3 files changed

Lines changed: 24 additions & 1 deletion

File tree

docs/superpowers/plans/2026-06-22-deploy-anywhere.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
44
5+
> **Amendment (2026-06-22, post-implementation).** This plan describes the
6+
> original 4-category build. The shipped feature added a 5th category afterward;
7+
> where this plan and the code differ, the code is authoritative:
8+
> - `CategoryId` is `'registry' | 'oss-paas' | 'kubernetes' | 'managed-paas' | 'cloud'`
9+
> (a `kubernetes` "Kubernetes & orchestration" category was added).
10+
> - GitHub star counts show on open-source platforms in **both** `oss-paas` and
11+
> `kubernetes` (the global constraint "ONLY on `oss-paas`" is superseded);
12+
> `starRepos` derives from both, and `FALLBACK_STARS` covers both.
13+
> - Koyeb/Render gained one-click `deployUrl`s (Render `planned → available`).
14+
515
**Goal:** Build a `/deploy` page plus a condensed homepage section that present LibreDB Studio's "one open-source image → every layer of the deploy stack" distribution story, with live GitHub star counts on open-source platform cards.
616

717
**Architecture:** A typed data layer (`src/data/`) is the single source of truth for every platform/registry. A build-time helper (`src/lib/github-stars.ts`) fetches star counts (with a baked fallback) and a client script refreshes them live. Astro components (`PlatformCard`, `StatusBadge`) render the data on a full `/deploy` page and a condensed homepage `DeployAnywhere` section.

docs/superpowers/specs/2026-06-22-deploy-anywhere-design.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,19 @@
44
**Status:** Approved design, ready for implementation plan
55
**Repo:** `libredb-website` (Astro 6, Tailwind v4, static output)
66

7+
> **Amendment (2026-06-22, post-implementation).** This spec captures the
8+
> original design. The shipped feature evolved during the PR; where the text
9+
> below says otherwise, the implementation is authoritative:
10+
> - **5 categories, not 4.** A `kubernetes` ("Kubernetes & orchestration")
11+
> category was added between `oss-paas` and `managed-paas`. So `CategoryId` is
12+
> `'registry' | 'oss-paas' | 'kubernetes' | 'managed-paas' | 'cloud'`, the stat
13+
> strip reads "5 categories", and the classification grids span ①–⑤.
14+
> - **Stars show on all open-source platforms**, i.e. targets with a `github`
15+
> repo in *either* `oss-paas` or `kubernetes` — not "OSS PaaS only". The
16+
> aggregate sums those.
17+
> - Koyeb and Render gained one-click `deployUrl`s (Render moved `planned →
18+
> available`); the Koyeb URL ships no default credentials.
19+
720
## 1. Purpose & audience
821

922
LibreDB Studio is now distributed as one-click apps / marketplace listings and as

src/data/deploy-targets.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ export interface DeployTarget {
1111
logo?: string; // '/logos/deploy/<slug>.svg' — omit for lettermark fallback
1212
deployUrl?: string; // one-click deploy link
1313
docsUrl?: string; // our deploy docs / repo instructions
14-
github?: string; // 'owner/repo' — live star count (oss-paas only)
14+
github?: string; // 'owner/repo' — live star count (open-source platforms: oss-paas + kubernetes)
1515
blurb?: string; // one short line
1616
}
1717

0 commit comments

Comments
 (0)