Skip to content

Add Docify CLI and restructure /docs as platform documentation#35

Merged
matthewrgourd merged 3 commits into
mainfrom
feat/docify-cli-and-docs-restructure
Apr 15, 2026
Merged

Add Docify CLI and restructure /docs as platform documentation#35
matthewrgourd merged 3 commits into
mainfrom
feat/docify-cli-and-docs-restructure

Conversation

@matthewrgourd
Copy link
Copy Markdown
Owner

Summary

Docify CLI (packages/cli/)

New @devdocify/cli npm package — the DevDocify equivalent of the Mintlify CLI. Install globally with npm i -g @devdocify/cli.

Command Description
docify dev Start local dev server (package manager aware)
docify build Production build
docify validate Run content linter
docify broken-links Build and report broken links
docify new <dir> Scaffold a new DevDocify project
docify update Upgrade CLI to latest
docify score <url> SEO signal check, score out of 6
docify analytics Algolia analytics guidance
docify a11y axe-core accessibility guidance
docify config Read/write ~/.docify/config.json

Docs restructure

/docs is now product documentation for the DevDocify platform itself (not the demo APIs):

  • New tutorials: quick start with the CLI
  • New how-to guides: add a docset, add a playground, configure Algolia search, deploy to Vercel
  • New reference: full CLI command reference

Playground guides moved to their own docsets:

  • docs/tfl/getting-started/playground.md
  • docs/petstore/getting-started/playground.md

Navigation updated across all three docsets.

Test plan

  • pnpm start builds without errors
  • /docs shows platform documentation (not demo API content)
  • /tfl/getting-started/playground and /petstore/getting-started/playground resolve correctly
  • CLI reference page renders at /docs/reference/cli
  • Quick start tutorial renders at /docs/tutorials/quick-start

## Docify CLI (packages/cli/)

New @devdocify/cli npm package — the DevDocify equivalent of the
Mintlify CLI. All commands start with `docify`.

Commands implemented:
- docify dev        start local dev server (package manager aware)
- docify build      production build
- docify validate   run lint-content script
- docify broken-links  build and report broken links
- docify new <dir>  scaffold a new DevDocify project
- docify update     upgrade CLI to latest
- docify score <url>  SEO signal check, score out of 6
- docify analytics  Algolia analytics guidance
- docify a11y       axe-core accessibility guidance
- docify config     read/write ~/.docify/config.json

## Docs restructure

/docs is now about the DevDocify platform, not the demo APIs:
- New tutorials: quick start with the CLI
- New how-to guides: add a docset, add a playground, configure
  search, deploy to Vercel
- New reference: full CLI command reference

Playground guides moved to their own docsets:
- docs/devdocify/how-to/tfl-playground.md
  → docs/tfl/getting-started/playground.md
- docs/devdocify/how-to/petstore-playground.md
  → docs/petstore/getting-started/playground.md

playground-overview.md renamed and reframed:
- docs/devdocify/how-to/add-playground.md

Navigation updated across all three docsets.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 15, 2026

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

Project Deployment Actions Updated (UTC)
doc-platform Ready Ready Preview, Comment Apr 15, 2026 4:02pm

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 15, 2026

Preview deployment

Status ✅ Ready
URL https://doc-platform-pq0820xy0-matthewrgourds-projects.vercel.app
Commit 010473f
Build Workflow run

Updated on each push to this PR.

@matthewrgourd matthewrgourd merged commit 9c9d1f8 into main Apr 15, 2026
10 checks passed
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