Getting Started

Installation

Install JSONBlog CLI globally using your preferred package manager:

npm install -g @jsonblog/cli
pnpm add -g @jsonblog/cli
yarn global add @jsonblog/cli

Quick Start

  1. 1.

    Create a blog.json file

    {
      "site": {
        "title": "My Blog",
        "description": "My thoughts and ideas"
      },
      "basics": {
        "name": "Your Name"
      },
      "posts": [
        {
          "title": "Hello World",
          "content": "# Hello World\n\nThis is my first post!",
          "createdAt": "2025-01-20"
        }
      ]
    }
  2. 2.

    Build your blog

    jsonblog build

    This generates your static site in the build/ directory.

  3. 3.

    Preview locally

    jsonblog serve

    Opens your blog at http://localhost:8080

  4. 4.

    Deploy

    Deploy the build/ directory to any static hosting service:

    • • Netlify
    • • Vercel
    • • GitHub Pages
    • • Cloudflare Pages
    • • Any web server

Development Mode

For live development with auto-reload:

jsonblog dev

This watches for changes to your blog.json and automatically rebuilds your site.

Next Steps