Release: README, live demo, CI, screenshots, CONTRIBUTING, i18n

[os-sam]

Card docs/backlog/14-release.md · Milestone M4 · Blocked-by: #4, #6, #7, #8

The card that turns a working repository into something a stranger can try. Until it lands, the project is code; after it, it is a reference app.

Scope

README.md (bilingual, screenshots, a "try it" link), CONTRIBUTING.md, .github/workflows/ci.yml, docs/screenshots/, src/translations/ (en and zh-CN bundles for object, field and nav labels — load objectstack-i18n), docker-compose.yml + Dockerfile from the ObjectStack blank template, and the live-demo link recorded in the README.

Spec

• CI — pnpm install --frozen-lockfile && pnpm validate && pnpm lint && pnpm typecheck on push and PR. This repo has had no CI at all until now; every gate result so far has been a human pasting a terminal tail into a PR body.
• i18n — 100 % label coverage for both locales (the i18n skill's coverage report), and an i18n block in defineStack with defaultLocale: 'en', supportedLocales: ['en', 'zh-CN'].
• Screenshots — pipeline kanban, interview calendar, funnel dashboard, and the three apps' home views. These are the first thing anyone sees; take them against demo-en with the seed loaded, not against an empty database.
• CONTRIBUTING — how to run the gates, the card workflow, DESIGN.md as architecture authority, and the no-vertical-vocabulary rule.

Acceptance

• A fresh clone: pnpm install && pnpm dev boots with seed in under two minutes on a laptop.
• CI green on main.
• The README's first screen answers what this is and how to try it, without scrolling.

Out of scope

New features. Changes to DESIGN.md §01–§03.

[os-sam]

Claim: session_01PbJ5Cy9KDAzeQHo8bsMadG · branch claude/issue-9-release

All four blockers are done — #4 (#29), #6 (#15), #7 (#57), #8 (#54). main is 18c1423.

Six things this card must account for that its text predates:

1. ⭐ CI is the single most valuable thing here. This repository has had no CI for its entire life. Every gate result on every one of the ~15 PRs merged this session was an agent or I pasting a terminal tail, and my review discipline exists only because there was nothing else. .github/workflows/ci.yml running install --frozen-lockfile && validate && lint && typecheck changes that permanently. Treat it as the card's centre of gravity, not a checklist item.

2. The README is no longer a stub — do not clobber it. It has accumulated the demo-logins table (#41), the --database-driver memory guidance and known-gaps list (#47, #52, #58), the demo-seed gate (#49) and the public application form (#51). Restructure it for a newcomer's first screen, but every one of those facts is measured and must survive.

3. ⚠️ Screenshots must be taken on --database-driver memory. On the default driver the four tenancy-scoped objects return no rows to platform personas (#39, still awaiting a maintainer decision), so the Platform group's review queues photograph empty. Shipping that as the project's shop window would misrepresent it.

4. ⛔ There is no deployment, so there is no live demo URL. The card asks for "a 'try it' link" and "the live-demo link recorded in the README". If nothing has been deployed, say so and leave it out — do not invent a URL or link a placeholder. A fabricated demo link in the README of a project whose whole review culture is "measure it, don't assert it" would be the worst possible thing to ship.

5. Two known gaps must appear, and one is new since the card: #45 (an employer cannot create a job, upstream) and #56 (F5/F6 select, mark and de-duplicate correctly but deliver nothing on the cron path — objectstack#16659). #58 just put both in the README and DESIGN §05; keep them.

6. The funnel numbers for the screenshots are 88 / 46 / 28 / 14 / 9, and the dashboards exist as of #54.

The acceptance I care most about is the card's own: a fresh clone, pnpm install && pnpm dev, boots with seed in under two minutes. Prove it from a genuinely clean checkout, not from a warm worktree.

---

Generated by Claude Code