Grow
[!NOTE]
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