Skip to content

docs: rewrite README and expand CONTRIBUTING guide - #14

Merged
CharanMN7 merged 2 commits into
mainfrom
docs/readme-and-contributing
Jul 26, 2026
Merged

docs: rewrite README and expand CONTRIBUTING guide#14
CharanMN7 merged 2 commits into
mainfrom
docs/readme-and-contributing

Conversation

@CharanMN7

Copy link
Copy Markdown
Contributor

Summary

This PR brings the repository's top-level documentation up to date with the current monorepo state after the theme consolidation (Canopy / Shadcn / Galley) and the 0.4.0 feature release.

README (README.md)

  • Fixed outdated theme references — replaced six archived themes (aurora, fern, cedar, mono, base, galley) with the three active scaffoldable themes and a link to archive/templates/
  • Added architecture diagram showing the content → framework → theme → deploy flow
  • Added CI and license badges plus Node 22 requirement
  • Expanded feature section into a scannable table covering MDX, native OpenAPI, MCP, AI ask-box, llms.txt, Pagefind search, blog/changelog, and self-hosting
  • Added themes comparison table with style descriptions and best-fit guidance
  • Added full monorepo package table with published/private status for every workspace
  • Documented CLI options (--theme, --openapi, -y) and the inkform-docs binary name
  • Expanded dev section with all three examples, all three themes, local scaffold workflow (--from templates), and e2e test note
  • Added documentation index linking to ARCHITECTURE, CONTRIBUTING, CHANGELOG, MIGRATION, and PUBLISHING

CONTRIBUTING (CONTRIBUTING.md)

  • Rewrote for current structure — correct theme names, workspace layout, archive explanation
  • Added theme contribution guide — the primary new content:
    • What makes a good theme contribution (distinct identity, token-driven, accessible)
    • Full theme contract summary (from ARCHITECTURE.md §12)
    • Step-by-step: copy canopy → restyle → verify → register in CLI → open PR
    • Review criteria table for maintainers
    • Guidance on community vs. CLI-included themes
  • Added engine and CLI contribution sections with file references and test commands
  • Added PR process with checklist (typecheck, test, build, ARCHITECTURE updates)
  • Documented CI pipeline and the deliberate e2e exclusion (PokéAPI fair use)
  • Added local scaffold testing workflow essential for theme/CLI development

Decisions

  • README links to CONTRIBUTING for theme contributions rather than duplicating the full workflow — keeps README scannable while CONTRIBUTING has the depth
  • Theme contract in CONTRIBUTING summarizes ARCHITECTURE.md §12 rather than copying it verbatim — single source of truth stays in ARCHITECTURE.md
  • Canopy recommended as the copy source for new themes (most complete reference implementation)

Test plan

  • Verified all linked paths exist in the repo (templates/canopy, archive/templates/, packages/framework/ARCHITECTURE.md, etc.)
  • Confirmed THEMES array in scaffold.mjs matches README/CONTRIBUTING theme list (canopy, shadcn, galley)
  • Confirmed CI workflow commands match CONTRIBUTING dev workflow section
  • No code changes — documentation only, no build/test required

Made with Cursor

CharanMN7 and others added 2 commits July 26, 2026 18:41
Replace outdated references to six archived themes (aurora, fern, cedar,
mono, base, galley) with the three active scaffoldable themes (canopy,
shadcn, galley). Add architecture diagram, feature table, CI/license
badges, CLI options, full workspace table, and links to ARCHITECTURE,
CONTRIBUTING, MIGRATION, and PUBLISHING docs. Document Node 22
requirement, local scaffold workflow (--from), and archive/ directory.

Co-authored-by: Cursor <cursoragent@cursor.com>
Rewrite contributor docs for the consolidated three-theme structure.
Add detailed theme contribution workflow: contract requirements, step-by-step
setup, review criteria, and CLI registration. Document local scaffold
testing (--from), CI gates, PR checklist, and engine/CLI contribution
paths. Clarify archive/templates/ purpose and e2e exclusion rationale.

Co-authored-by: Cursor <cursoragent@cursor.com>
@CharanMN7
CharanMN7 merged commit 9a94914 into main Jul 26, 2026
1 of 4 checks passed
@vercel

vercel Bot commented Jul 26, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
framework-inkform-docs Building Building Preview, Comment Jul 26, 2026 1:12pm
pokeapi Building Building Preview, Comment Jul 26, 2026 1:12pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant