feat(repo): add zpress documentation site by zrosenbauer · Pull Request #85 · joggrdocs/kidd

zrosenbauer · 2026-03-18T17:56:52Z

Summary

Adds zpress as the documentation framework, wired up to all existing docs
Installs @zpress/kit and creates zpress.config.ts mapping the full information architecture
Adds docs scripts (docs:dev, docs:build, docs:serve, docs:sync, docs:clean)
Updates .gitignore for .zpress/ build artifacts

Sections

Section	Source
Introduction	`docs/README.md`
Concepts	`docs/concepts/*.md`
Guides	`docs/guides/*.md`
Reference	`docs/reference/*.md`
Contributing	`contributing/` (concepts, guides, standards)
Packages	Metadata for all 5 monorepo packages

Known issues

3 broken links in contributing docs — relative references to CLAUDE.md, CONTRIBUTING.md, and contributing/README.md that exist on GitHub but not in the docs site. Will address in a follow-up.

Test plan

pnpm docs:dev starts dev server at localhost:6175
pnpm docs:sync syncs all 50 pages without errors
All sections render correctly in sidebar
Fix or remove broken links in contributing docs

changeset-bot · 2026-03-18T17:56:57Z

⚠️ No Changeset found

Latest commit: 45cde70

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Add zpress configuration, Vercel static site deployment config, and resolve pnpm-lock.yaml merge conflict with main. Co-Authored-By: Claude <noreply@anthropic.com>

vercel · 2026-03-18T21:41:20Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
oss-kidd	Ignored	Preview	Mar 18, 2026 11:55pm

codspeed-hq · 2026-03-18T21:44:11Z

Merging this PR will not alter performance

✅ 2 untouched benchmarks

_{Comparing feat/zpress (45cde70) with main (16afb63)}

Relative links to CLAUDE.md, CONTRIBUTING.md, and contributing/README.md break after zpress content sync since those files are outside the sync boundary. Replace with absolute GitHub URLs as a workaround. See: joggrdocs/zpress#48 Co-Authored-By: Claude <noreply@anthropic.com>

- Rewrite introduction.md as user-facing intro (was developer README) - Add quick-start.md with minimal getting-started guide - Add features, packages, nav, and sidebar.below to zpress config - Move Contributing to sidebar-only (isolated section) - Replace zpress-generated SVG assets with braille art from repo banner recolored to docs purple theme (#a78bfa), without the generated marker so zpress won't overwrite them Co-Authored-By: Claude <noreply@anthropic.com>

- Widen logo viewBox to 1060 and use text-anchor="middle" to prevent cutoff - Center icon K art at (256, 65) with text-anchor="middle" for dead center Co-Authored-By: Claude <noreply@anthropic.com>

Remove text-anchor="middle" which centered each line independently and warped the art. Instead keep lines left-aligned and shift the entire group as a block. Widen logo viewBox to 960 to prevent clipping. Co-Authored-By: Claude <noreply@anthropic.com>

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

49 chars wide, 23 lines (y 9-273). Computed translate from measured art block size to center within 512x512 background. Co-Authored-By: Claude <noreply@anthropic.com>

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

- Logo/icon brand color to #d8b4fe (violet-300, bright neon purple) - Set zpress theme to midnight (dark mode) Co-Authored-By: Claude <noreply@anthropic.com>

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

Keep vercel and zpress ignore entries from feat/zpress branch. Co-Authored-By: Claude <noreply@anthropic.com>

Eliminates MODULE_TYPELESS_PACKAGE_JSON warning from zpress dev. Co-Authored-By: Claude <noreply@anthropic.com>

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

chore: init

07698b6

chore(repo): setup zpress docs site with Vercel deployment

e94f3bc

Add zpress configuration, Vercel static site deployment config, and resolve pnpm-lock.yaml merge conflict with main. Co-Authored-By: Claude <noreply@anthropic.com>

vercel bot had a problem deploying to Production March 18, 2026 21:41 Failure

vercel bot deployed to Preview March 18, 2026 21:47 View deployment

vercel bot deployed to Preview March 18, 2026 22:38 View deployment

zrosenbauer and others added 7 commits March 18, 2026 18:45

fix(docs): center logo and icon braille art SVGs

e0eccb2

- Widen logo viewBox to 1060 and use text-anchor="middle" to prevent cutoff - Center icon K art at (256, 65) with text-anchor="middle" for dead center Co-Authored-By: Claude <noreply@anthropic.com>

fix(docs): adjust icon translate to center K art in background

232b609

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

fix(docs): center icon art using calculated dimensions

600002d

49 chars wide, 23 lines (y 9-273). Computed translate from measured art block size to center within 512x512 background. Co-Authored-By: Claude <noreply@anthropic.com>

fix(docs): darken logo and icon brand color to #7c3aed

b524ea8

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

fix(docs): use vibrant violet-500 (#8b5cf6) for logo and icon

5d18da0

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

docs: neon purple brand color and midnight theme

6114337

- Logo/icon brand color to #d8b4fe (violet-300, bright neon purple) - Set zpress theme to midnight (dark mode) Co-Authored-By: Claude <noreply@anthropic.com>

vercel bot deployed to Preview March 18, 2026 23:05 View deployment

zrosenbauer and others added 2 commits March 18, 2026 19:12

fix(docs): use near-white violet (#ede9fe) for logo and icon

8642ed8

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

docs: remove internal @kidd-cli/config from packages table

dee95da

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

vercel bot deployed to Preview March 18, 2026 23:15 View deployment

zrosenbauer and others added 3 commits March 18, 2026 19:16

chore: resolve .gitignore merge conflict

9ec9bd0

Keep vercel and zpress ignore entries from feat/zpress branch. Co-Authored-By: Claude <noreply@anthropic.com>

chore: add type module to root package.json

75dd02c

Eliminates MODULE_TYPELESS_PACKAGE_JSON warning from zpress dev. Co-Authored-By: Claude <noreply@anthropic.com>

chore: fix root license field to MIT

45cde70

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(repo): add zpress documentation site#85

feat(repo): add zpress documentation site#85
zrosenbauer wants to merge 16 commits intomainfrom
feat/zpress

zrosenbauer commented Mar 18, 2026

Uh oh!

changeset-bot bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

codspeed-hq bot commented Mar 18, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

zrosenbauer commented Mar 18, 2026

Summary

Sections

Known issues

Test plan

Uh oh!

changeset-bot bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

vercel bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codspeed-hq bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merging this PR will not alter performance

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

changeset-bot bot commented Mar 18, 2026 •

edited

Loading

vercel bot commented Mar 18, 2026 •

edited

Loading

codspeed-hq bot commented Mar 18, 2026 •

edited

Loading