nf

nf is nonfiction's internal CLI for agency WordPress theme work.

It gives the team one command surface for project metadata, local WordPress dev envs, theme tasks, theme packaging, provider inventory, repo remotes, password derivation, and guarded future deploy/sync workflows.

This is an internal agency tool, not a general-purpose public WordPress framework.

Quick Start

Install the latest nf from the GitHub flake into your Nix profile:

nix profile add github:nonfiction/nf

Configure global settings before creating or managing projects:

nf config init
nf password set-salt <shared-salt>

Create repo metadata, then run project-local commands from that repo:

nf init
nf env up
nf env show
nf theme tasks
nf theme package

Common Commands

nf --help
nf version
nf provider list
nf site list --envs
nf env wp -- plugin list
nf theme deploy production --dry-run
nf alias status production

Documentation

Start with the documentation index or the usage guide.

Common practical guides:

• Local development
• Targets
• Sites
• Staging
• Remotes
• Themes
• Aliases
• Snapshots
• Sync
• Domains and launch

For the full project model, state layout, implementation phases, and roadmap, see SPEC.md.