# google/docsy

Hugo theme for open source documentation

Repository: https://github.com/google/docsy
Canonical: https://ross.abutalabs.com/products/docsy
Homepage: https://docsy.dev
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: docsy, hugo, theme, documentation-site, hugo-theme, documentation-website
Last push: 2026-08-26T18:14:47+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 83, longevity 100
- inputs: {"age_days": 2879, "days_push": 7, "days_rel": 35, "gap_med": 74.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2961, forks 977 (observed 2026-08-28T04:07:32.320161+00:00)

## What it is
Docsy is a Hugo theme specifically designed for building technical documentation sites, providing navigation, site structure, and documentation best practices out of the box. It can be installed as an npm package, Hugo module, or Git submodule and is actively maintained by Google.

## Use cases
- build a documentation site for an open source project
- create technical docs with Hugo
- set up a project docs website with navigation and search
- host a documentation set with a blog section
- generate a static documentation website from Markdown
- bootstrap a docs site from a template

## When to choose
- you use Hugo and want a docs-focused theme with best practices built in
- you want a fast static documentation site with minimal setup
- you need multi-language documentation support
- you want to focus on writing content rather than site plumbing

## When to avoid
- your docs are generated from code annotations and need API-doc tooling like Docusaurus or Sphinx
- you need a dynamic, server-rendered documentation app
- you don't want a Node/Go toolchain dependency for building CSS and the site

## Facets
- artifact type: plugin
- maturity: active
- function: static-site-generator, documentation, templating, ui-components
- domain: documentation, web-development, developer-tools
- platform: cross-platform
- tags: hugo-theme, docs-site, technical-documentation, static-site, open-source-docs, web-server, nodejs

## Member repositories
- google/docsy (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:32.320161+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:32:09.359524+00:00, confidence not recorded.
  - readme: https://github.com/google/docsy (fetched 2026-08-28T04:07:32.320161+00:00, sha c7f6252232ff)
  - homepage: https://docsy.dev (fetched 2026-08-29T09:47:56.439656+00:00, sha 76de58615aec)
  - site_page: https://www.docsy.dev/about (fetched 2026-08-29T09:47:56.448985+00:00, sha de617823f49c)
  - site_page: https://www.docsy.dev/docs (fetched 2026-08-29T09:47:56.451196+00:00, sha 3f2ad87fe846)
  - site_page: https://www.docsy.dev/docs/get-started (fetched 2026-08-29T09:47:56.453111+00:00, sha 3674630994cc)
  - site_page: https://www.docsy.dev/docs/contributing (fetched 2026-08-29T09:47:56.454813+00:00, sha d997998eb363)
- Data as of 2026-08-30T08:39:29.467469+00:00.