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 - BetterTyped/docsgen: 📖 Documentation generator based on typedoc and react components. Automate your process completely or inject partial generated data into your md docs pages, so you never have to think about updating properties, parameters, methods or any other changing part of it. Just read it from your code!

BranchesTags
Open more actions menu

Latest commit

 

History

79 Commits
79 Commits

Folders and files

NameName
Last commit message
Last commit date
.bin
.bin
 
 
.cursor
.cursor
 
 
.github
.github
 
 
.husky
.husky
 
 
.vscode
.vscode
 
 
assets
assets
 
 
documentation
documentation
 
 
packages
packages
 
 
src
src
 
 
.editorconfig
.editorconfig
 
 
.env
.env
 
 
.gitignore
.gitignore
 
 
.npmignore
.npmignore
 
 
.nvmrc
.nvmrc
 
 
.oxfmtrc.json
.oxfmtrc.json
 
 
.oxlintrc.json
.oxlintrc.json
 
 
.snyk
.snyk
 
 
Code_of_Conduct.md
Code_of_Conduct.md
 
 
Contributing.md
Contributing.md
 
 
License.md
License.md
 
 
README.md
README.md
 
 
commitlint.config.js
commitlint.config.js
 
 
migrations.json
migrations.json
 
 
nx.json
nx.json
 
 
package.json
package.json
 
 
pnpm-lock.yaml
pnpm-lock.yaml
 
 
pnpm-workspace.yaml
pnpm-workspace.yaml
 
 
release.config.js
release.config.js
 
 
tsconfig.base.json
tsconfig.base.json
 
 
tsconfig.json
tsconfig.json
 
 

Repository files navigation

Beautiful API docs from TypeScript source. Zero effort.

Generate fully structured, always-accurate API documentation for your Docusaurus site directly from TypeScript source code. Every page stays in sync with your code automatically.

Documentation | Quick Start | Guides

npm npm license


Quick Start

1. Install

npm install @docsgen/core @docsgen/docusaurus

2. Add the plugin

import plugin from "@docsgen/docusaurus";

const config = {
  plugins: [
    [
      "@docsgen/docusaurus",
      {
        id: "api",
        outDir: "docs/api",
        packages: [
          {
            title: "my-library",
            dir: "../packages/my-library",
            entryPath: "src/index.ts",
          },
        ],
      },
    ],
  ],
};

3. Build

npm run build

That's it. Structured MDX pages for every class, function, type, and enum appear in docs/api/, organized by category and always matching your source.

Why docsgen?

  • Always accurate - Pages regenerate on every build from your TypeScript source. Change a type, rename a method, add a parameter: the docs update automatically.
  • Structured output - Classes, functions, types, enums, and variables each get dedicated pages with parameters, return types, method tables, signatures, and examples.
  • Embed API in guides - Use the @import directive to embed live API fragments (method tables, parameter lists, type definitions) inside hand-written MDX. They never go stale.
  • Monorepo ready - Generate docs for multiple packages in a single Docusaurus site with per-package configuration, separate entry points, and optional index pages.
  • Fully customizable - Override page templates per kind, control which sections render, remap file names, filter symbols, and reorder categories.
  • Built on TypeDoc - Leverages TypeDoc for parsing with full support for JSDoc tags, generics, and complex type hierarchies.

Packages

Package Version Downloads
@docsgen/core npm downloads
@docsgen/docusaurus npm downloads

Examples

Generated output structure

docs/api/
  my-library/
    index.mdx
    Classes/
      MyClass.mdx
    Functions/
      myFunction.mdx
    Types/
      MyType.mdx
    Enums/
      MyEnum.mdx

Embed API fragments in guides

Add the importer remark plugin to your Docusaurus config:

import { importer } from "@docsgen/core";

const config = {
  presets: [
    [
      "classic",
      {
        docs: {
          remarkPlugins: [
            importer({
              packageRoute: "api",
              apiDir: "docs/api",
            }),
          ],
        },
      },
    ],
  ],
};

Then use @import directives in any MDX file:

(@import my-library MyClass type=methods&display=table)

(@import my-library createClient type=parameters&display=table)

(@import my-library MyClass type=properties&display=grid)

This renders live, always-up-to-date API fragments directly in your hand-written documentation.

Documentation

  • Getting Started
  • Quick Start
  • Configuration
  • Importer
  • Customization
  • Guides

Help us keep working on this project

Sponsoring is an important part of docsgen's growth. We strongly encourage you to help us maintain the project and shape its future.

  • Become a Sponsor on GitHub

How can I support the developers?

  • Star our GitHub repo
  • Create pull requests, submit bugs, suggest new features or documentation updates
  • Spread the word

Contributing

We welcome contributions of all kinds. Check the Contributing Guide, fork the repository, make your changes, and send a pull request. We will be glad to consider your suggestions.

License

Apache-2.0

Contact

If you have questions, start a new discussion thread on the docsgen GitHub. For direct inquiries, reach out via email (listed on our profiles).

About

📖 Documentation generator based on typedoc and react components. Automate your process completely or inject partial generated data into your md docs pages, so you never have to think about updating properties, parameters, methods or any other changing part of it. Just read it from your code!

bettertyped.github.io/docsgen/

Topics

documentation-generatordocumentation-tooldocusaurus-plugindocusaurus-v2typescript

Resources

Readme
Apache-2.0 license

Code of conduct

Code of conduct

Contributing

Contributing
Activity
Custom properties

Stars

9 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Sponsor this project

Packages

Used by

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.