NostalgiaPHP

Nosty CLI — Your New Best Friend

Meet Nosty CLI, a tiny helper script included with NostalgiaPHP.

With it, you can scaffold new blog posts or pages right from the command line — no more copy‑pasting front‑matter by hand.

Usage

The CLI lives in the project root. Run it like so:

php nphp make:post blog hello-world
php nphp make:page about/contact
  • make:post creates content/collections/{collection}/{slug}.md
  • make:page creates content/pages/{slug}/index.md (foldered pages for easy assets).

Both commands accept the same options:

  • --title="Custom Title" (defaults to a titleized slug)
  • --template=main (choose your template)
  • --date=YYYY-MM-DD (defaults to today in your site timezone)
  • --draft (adds draft: true)
  • --force (overwrite if the file exists)

Examples

# Blog post
php nphp make:post blog hello-world --title="Hello, World" --template=main --draft

# Docs page (folder + index.md)
php nphp make:page getting-started --title="Getting Started" --template=main

That yields front-matter like:

---
title: Hello, World
description:
date: 2025-09-28
template: main
draft: true
---

Backups

You can back up your entire project with the backup command.

By default, backups are saved to your home directory under ~/nosty_backups/<project>/.

php nphp backup

This will create a zip archive like: ~/nosty_backups/MyProject/MyProject-2025-09-28-143000.zip

Custom location

You can also specify a different target directory with --to:

php nphp backup --to=/path/to/backups

Notes

  • Backups include your whole project folder.
  • Common directories like .git and node_modules are excluded automatically.
  • Old backups are not deleted. Manage them yourself by removing old archives.
  • Requires the PHP zip extension.

Why It Matters

Consistency, speed, and fewer typos.

Embrace lazy. Let Nosty handle the boilerplate, and you can focus on writing.