GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - pmndrs/docs: 🖨️ mdx static documentation generator

BranchesTags
Open more actions menu

Latest commit

 

History

1,266 Commits
1,266 Commits

Folders and files

NameName
Last commit message
Last commit date
.agents/skills/shadcn
.agents/skills/shadcn
 
 
.changeset
.changeset
 
 
.claude
.claude
 
 
.github
.github
 
 
.husky
.husky
 
 
.storybook
.storybook
 
 
bin
bin
 
 
docs
docs
 
 
public
public
 
 
registry
registry
 
 
scripts
scripts
 
 
src
src
 
 
.gitignore
.gitignore
 
 
.lintstagedrc.mjs
.lintstagedrc.mjs
 
 
.nvmrc
.nvmrc
 
 
.prettierignore
.prettierignore
 
 
.prettierrc.mjs
.prettierrc.mjs
 
 
CHANGELOG.md
CHANGELOG.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
components.json
components.json
 
 
dev.sh
dev.sh
 
 
docs.config.ts
docs.config.ts
 
 
eslint.config.mjs
eslint.config.mjs
 
 
next-env.d.ts
next-env.d.ts
 
 
next.config.mts
next.config.mts
 
 
package.json
package.json
 
 
pnpm-lock.yaml
pnpm-lock.yaml
 
 
postcss.config.mjs
postcss.config.mjs
 
 
preview.sh
preview.sh
 
 
registry.json
registry.json
 
 
server.json
server.json
 
 
skills-lock.json
skills-lock.json
 
 
start.sh
start.sh
 
 
tsconfig.json
tsconfig.json
 
 
vitest.config.ts
vitest.config.ts
 
 

Repository files navigation

docs/getting-started/introduction.mdx

Usage

Read

$ npx @pmndrs/docs                                 # the reader: every library, every page
$ npx @pmndrs/docs drei                            # straight into one
$ npx @pmndrs/docs drei/performances/instances     # straight to a page
$ npx @pmndrs/docs search instanced mesh           # one result per line, on stdout

See read for keys, search and caching.

Build

$ cat foo.mdx | npx @pmndrs/docs@latest build               # one HTML fragment, on stdout
$ npx @pmndrs/docs@latest build docs out                    # one .html per .mdx, assets alongside
$ npx @pmndrs/docs@latest build docs out --format website   # the whole website, statically exported

See CLI for formats, flags, previewing and docs.config.ts.

Releasing

Every push to main redeploys docs.pmnd.rs via ci.yml — no changeset needed for that.

Add one (pnpm changeset) only when downstream consumers pinning pmndrs/docs/.github/workflows/build.yml@v4 or @pmndrs/docs@4 should pull the change. It bumps package.json, publishes to npm, and tags vX.Y.Z + vX — so @v4 resolves to the latest.

TL;DR — site-only tweak: skip. Anything consumers see (workflow, build behavior, templates): add one.

Test

Visual tests are performed in the cloud, through chromatic-storybook.yml.

  • pnpm run lgtm — the gate CI runs (lgtm.yml): types, lint, registry validation, unit tests.

About

🖨️ mdx static documentation generator

pmndrs.github.io/docs/

Topics

documentationgithub-actionsgithub-pagesmcpmcp-servermdxmodel-context-protocolnextjsstaticvercel

Resources

Readme
MIT license
Activity
Custom properties

Stars

120 stars

Watchers

4 watching

Forks

100 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.