nf is nonfiction's internal CLI for agency website work. WordPress workflows are established. nterchange support covers project metadata, SSH/Compose discovery, guarded SQL/media pulls, locked code packaging and per-site code activation/rollback. Activation has been tested only on a disposable synthetic PHP target, not an existing CMS site.
It manages local WordPress environments, theme and plugin work, provider inventory, repo remotes, password derivation, and guarded deployment and data sync.
This is an internal agency tool, not a general-purpose public WordPress framework.
Install the latest nf from the GitHub flake into your Nix profile:
nix profile add github:nonfiction/nfConfigure 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 packagenf --help
nf version
nf provider list
nf site list --envs
nf env wp -- plugin list
nf theme deploy production --dry-run
nf alias status productionLong options that take values accept both --flag value and --flag=value.
Start with the documentation index or the usage guide.
Common practical guides:
- Local development
- nterchange and SSH targets
- 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.