Finnimal

A clean and minimal WordPress Block Theme.

Named after my dog Finn.

For Users

Installing the Theme

1. Download this theme as a ZIP file
2. In your WordPress admin, go to Appearance → Themes
3. Click Add New → Upload Theme
4. Upload the ZIP file and activate

Customizing

Finnimal supports the WordPress Site Editor (Full Site Editing). Go to Appearance → Editor to customize:

• Colors and typography
• Header and footer layouts
• Page templates
• Dark/light mode (follows system preference automatically)
• And more

For Developers

Prerequisites

• Node.js 18+
• npm 9+
• WordPress 7.1+
• PHP 8.3+

Setup

npm install

Development

Start the WordPress Playground server with live reload:

npm run start

This opens a local WordPress instance where you can test changes.

Available Commands

Command	Description
npm run start	Start dev server (WordPress Playground)
npm run format	Format code
npm run lint:css	Lint CSS files
npm run lint:js	Lint JavaScript files
npm run lint:pkg-json	Lint package.json
npm run packages-update	Update WordPress packages
npm run zip	Create distributable ZIP

Formatting and linting commands are run automatically on the pre-push hook via .husky/pre-push

Project Structure

finnimal/
├── templates/       # Theme template files (.html)
├── parts/           # Reusable parts (footer, header, etc.)
├── patterns/        # Reusable block patterns
├── functions.php    # Theme functions and setup
├── style.css        # Theme metadata and custom styles
├── theme.json       # Theme settings and styles
├── .wordpress/      # WordPress Playground blueprints
├── src/              # JavaScript source files
└── package.json     # npm scripts and dependencies

License

GPL-2.0-or-later