Taxo Theme Documentation

Installation Guide

Taxo requires Node.js 22.12.0 or later. That version comes from the theme’s package.json, so matching it helps avoid setup and build issues.

Tip

Use the theme’s built-in npm scripts whenever possible. They handle the setup steps Taxo needs during development and production builds.

Install Node.js

Windows

1. Download Node.js from nodejs.org.
2. Install it with the default setup.
3. Verify the version:

node -v

You should see v22.12.0 or newer.

macOS

1. Install Homebrew if you do not already have it.
2. Install Node.js:

brew install node

3. Verify the version:

node -v

Linux

Install Node.js using your preferred package manager or the official Node installer, then verify it:

node -v

Install Dependencies

Inside the taxo/ project folder, run:

npm install

Start Development

npm run dev

Taxo’s dev script also starts the TOML watcher. That means changes in src/config/config.toml regenerate .astro/config.generated.json automatically.

Run Quality Checks

npm run astro-check

Create A Production Build

npm run build

That sequence:

1. regenerates config from TOML
2. builds the Astro site
3. removes draft pages from the sitemap

Useful Extra Scripts

npm run generate-favicons
npm run generate-multilingual-content
npm run remove-multilingual
npm run test

• generate-favicons rebuilds favicon assets from your source logo.
• generate-multilingual-content helps create translated content folders.
• remove-multilingual strips multilingual support from the project when you want a single-language site.
• test runs the Jest test suite.