Skip to content

feat(shipyard): shipyard's website and docs at coss.com/shipyard - #863

Merged
PeerRich merged 2 commits into
mainfrom
feat/shipyard-app
Oct 12, 2026
Merged

PeerRich merged 2 commits into
mainfrom
feat/shipyard-app

Conversation

@PeerRich

Copy link
Copy Markdown
Contributor

What

A new app, apps/shipyard, served at coss.com/shipyard the way coss ui is served at /ui (basePath: "/shipyard").

Landing page (/shipyard): the page from berthd.app, under coss.com's header, rails and theme.

  • The dithered harbour that comes alive at night, the six chapters with the app's line scenes and loops, the install line. Its own type (Inter, JetBrains Mono) and tokens stay; night follows the site's theme switch instead of its own.
  • Header: coss.com shipyard, Docs, Download, the docs' search (⌘K), GitHub with cosscom/shipyard's stars, theme switch.
  • The film's lightbox is left out until the film is hosted.

Docs (/shipyard/docs): moved here from cosscom/shipyard's docs/ folder (47 pages), on the same Fumadocs setup as coss ui's docs: source.config.ts, docs layout, sidebar, search, table of contents, Copy Markdown, .md routes. Shipyard's own pieces are ported into components/docs/: callouts, the stage, the numbered path of cards, screenshots (light/dark), diagrams, the line scenes, and the rehype plugin that makes the reference tables linkable. Internal links are rewritten to /docs/....

Shared: SiteHeader / GitHubLink take an optional github={{ repo, href }} so a product can point at its own repository (default unchanged). siteConfig.products has shipyard.

Stays on berthd.app (built from cosscom/shipyard)

The app downloads, the live demo (berthd.app/demo/), the box install line (berthd.app/install), the plugin listing and the Review in Shipyard bounce page. The landing page links to them there.

To deploy

  • A Vercel project for apps/shipyard (root directory apps/shipyard), and the /shipyard/:path* rewrite from coss.com to it, the same way /ui reaches apps/ui.
  • Afterwards, in cosscom/shipyard: redirect berthd.app → coss.com/shipyard and docs.berthd.app → coss.com/shipyard/docs, and drop site/index.html + docs-site/ there (the docs' source now lives here).

Checks

  • bun run build, tsc --noEmit and biome check for apps/shipyard pass (7 biome warnings in vendored CSS and the ported rehype plugin, no errors).
  • tsc --noEmit passes for apps/ui, apps/www and packages/ui.
  • Checked in a browser at 1600 and 390 wide, light and dark: harbour draws and goes live at night, scenes and loops load, no console errors, no sideways scroll; docs introduction, a guide and the CLI reference render.

🤖 Generated with Claude Code

A new app, apps/shipyard, served under /shipyard like coss ui under /ui.
The landing page is the one from berthd.app, under coss.com's header,
rails and theme: the dithered harbour that comes alive at night, the six
chapters with the app's line scenes and loops, the install line. Its own
type and tokens stay; the header shows "coss.com shipyard", Docs,
Download, the docs' search, Shipyard's repository and its stars, and the
theme switch.

The docs move here from the cosscom/shipyard repository's docs/ folder,
on the same Fumadocs setup as coss ui's docs (sidebar, search, table of
contents, Copy Markdown, .md routes), with Shipyard's own pieces ported:
callouts, the stage, the path of cards, screenshots, diagrams, the line
scenes, and the reference tables made linkable.

The shared header takes the product's repository for its GitHub link,
and the products list has shipyard.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
coss-com Ready Ready Preview Oct 12, 2026 10:47am UTC
coss-com-origin Ready Ready Preview Oct 12, 2026 10:47am UTC
coss-com-ui Ready Ready Preview Oct 12, 2026 10:47am UTC
coss-examples-calcom Ready Ready Preview Oct 12, 2026 10:47am UTC

Request Review

…s package

fumadocs-mdx bundles @coss/ui's highlight-code into source.config.mjs,
which imports @shikijs/transformers. CI's frozen install could not
resolve it from apps/shipyard. Declared like apps/ui does.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@PeerRich
PeerRich merged commit 0ac96b5 into main Oct 12, 2026
13 checks passed
@PeerRich
PeerRich deleted the feat/shipyard-app branch October 12, 2026 12:10
@linear-code

linear-code Bot commented Oct 12, 2026

Copy link
Copy Markdown

ENG-5928

This branch was successfully deployed

4 active deployments
Preview – coss-com-origin — 95d3f55d Deployed Oct 12, 2026 by vercel[bot]
Preview – coss-com-ui — 95d3f55d Deployed Oct 12, 2026 by vercel[bot]
Preview – coss-examples-calcom — 95d3f55d Deployed Oct 12, 2026 by vercel[bot]
Preview – coss-com — 95d3f55d Deployed Oct 12, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants