# chrisdiana/cms.js

Client-Side JavaScript Site Generator

Repository: https://github.com/chrisdiana/cms.js
Canonical: https://ross.abutalabs.com/products/cmsjs
Homepage: http://chrisdiana.github.io/cms.js
Language: JavaScript
License: MIT
License Family: permissive
Topics: javascript, static-site-generator, file-based, single-page-app, markdown, markdown-parser
Last push: 2024-07-04T06:50:52+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3890, "days_push": 790, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3056, forks 280 (observed 2026-08-28T04:07:39.775286+00:00)

## What it is
CMS.js is a fully client-side JavaScript Markdown site generator in the spirit of Jekyll that renders Markdown content into a complete single-page website without any server-side scripting. It supports GitHub Pages and self-hosted server modes, with tagging, filtering, searching, sorting, and customizable themes.

## Use cases
- host a markdown blog on GitHub Pages without a backend
- build a static documentation site with plain HTML, CSS and JavaScript
- create a file-based CMS site with no Node.js, PHP or Ruby
- set up a personal blog in minutes using markdown files
- self-host a lightweight single-page content site
- add tagging, search and filtering to a static markdown site

## When to choose
- you want a Jekyll-like site generator that runs entirely in the browser
- you want to host content on GitHub Pages with zero server-side dependencies
- you need a tiny (~10kb) zero-dependency site generator with markdown rendering
- you want a simple file-based CMS for a blog or docs site

## When to avoid
- you need server-side rendering, SEO-critical dynamic routing, or a full CMS admin panel
- you need a build pipeline with plugins, asset bundling, or modern framework integration
- you need multi-user content editing or database-backed content management

## Facets
- artifact type: library
- maturity: maintenance
- function: static-site-generator, markdown, templating, search-engine, parser
- domain: web-development, frontend, cms, documentation
- platform: browser, cross-platform
- tags: client-side, single-page-app, file-based-cms, jekyll-alternative, github-pages, no-backend, blogging, javascript, web-server

## Member repositories
- chrisdiana/cms.js (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:39.775286+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:28:49.649003+00:00, confidence not recorded.
  - readme: https://github.com/chrisdiana/cms.js (fetched 2026-08-28T04:07:39.775286+00:00, sha d3f5728d4c8a)
  - homepage: http://chrisdiana.github.io/cms.js (fetched 2026-08-29T09:44:08.438421+00:00, sha 80d5f349fd86)
- Data as of 2026-08-30T08:39:29.467469+00:00.