Profile
Back to NewsBack
GitHub Trending 2 min
Reader Mode
grow/grow: A declarative website generator designed for high-quality websites, with a focus on easy maintenance and localization.

grow/grow: A declarative website generator designed for high-quality websites, with a focus on easy maintenance and localization.

23 hours ago

Grow

PyPI</a> Python</a> Test</a> Lint</a> License: MIT</a>

[!NOTE]
Root.js  Maintenance mode: Grow is actively maintained for existing v2.x sites with bug fixes and dependency updates, but for new projects we recommend Root.js (GitHub) — our modern successor built with TypeScript, Preact/TSX, file routing, i18n, and a built-in CMS.

Grow is a declarative, file-based static site generator for rapid, high-quality web site production.

Key Features

  • Data-driven content: Author content in YAML, JSON, and Markdown—keeping content cleanly separated from presentation.
  • Jinja2 templates: Bind structured content collections to reusable HTML templates and partials.
  • Declarative routing & URLs: Configure URL structures in YAML and reference pages/assets with template tags so URL changes never break links.
  • Built-in internationalization (i18n): Tag strings for translation, manage PO message catalogs, and localize content site-wide or per document.
  • Integrations: Pull content from Google Drive/Docs/Sheets and Blogger, or sync translations with Google Sheets.
  • Deploy anywhere: Build to a self-contained static fileset or deploy directly via built-in targets (local, Git, WebReview, and custom extensions).

Requirements

  • Python 3.9 – 3.12

Installation

Install Grow with uv or pip:

# Install globally as a CLI tool with uv (recommended)
uv tool install grow

Or install with pip

pip install grow

Quick Start

Try the built-in zero-Node starter project in examples/starter/:

git clone https://github.com/grow/grow.git
cd grow
uv sync
uv run grow run examples/starter

Or run the grow.dev documentation site locally:

uv run grow run docs

Common Commands

grow run                     # Start the local development server
grow build                   # Build the static site to ./build/
grow deploy <destination>    # Deploy to a configured destination in podspec.yaml
grow translations extract    # Extract translatable strings to message catalogs
grow --help                  # Show all available commands

Docker

Prebuilt images containing Grow, Python, Node.js, Yarn, and Google Cloud CLI are published to Docker Hub and GitHub Container Registry:

docker run --rm -it -v "$PWD":/site -w /site grow/base grow build

Development

Grow uses uv, pytest, and ruff for local development:

git clone https://github.com/grow/grow.git
cd grow
uv sync
uv run pytest
uv run ruff check grow/ install.py

See CONTRIBUTING.md for the full contributor guide.

Documentation & License

  • Documentation: https://grow.dev
  • Source code: https://github.com/grow/grow
  • License: MIT
Chat with me