Start here

Quickstart

Make a blog with Pluto and publish your first post in five minutes. You need no account and no database.

This page uses the default setup of Pluto: the blog template with the Git CMS. Your posts are Markdown files in the project, and each save is a Git commit. You need no account, no database, and no settings.

You need Node.js 22 or newer.

Create the project

Run this command in a terminal:

npm create pluto@latest

The CLI asks some questions. Press Enter at each question to keep the default. The defaults are the Git CMS and the blog template. The CLI then downloads the template and installs the dependencies.

To see the templates before you start, open the templates store. Each template has a live demo.
The terminal after create-pluto, with the next steps
The terminal at the end of create-pluto, with the Next steps box

Start the dev server

Go into the project folder and start the dev server:

cd my-pluto-project
npm run dev

Open http://localhost:3000. The blog shows one sample post, Hello, world.

Open the admin

Open http://localhost:3000/admin. On your machine, you do not sign in: the dev server signs you in as a Local user. The dashboard shows your posts.

The Pluto admin dashboard of a new blog
The admin dashboard of a new blog, signed in as Local

Write a post

Select New Post. Type a title, and write the text in the editor. Then select Publish.

The post editor with a title and some text
The New Post editor with a title, some text, and the Publish button

Pluto writes the post to content/posts/<slug>.md and makes a Git commit in your project. Select Save draft in place of Publish to keep a post off the site.

See it on the site

Select View site in the admin bar. Your post is on the home page. While you are signed in, the admin bar shows on the site too, with Edit Post on a post page.

The blog home page with the new post
The blog home page with the new post and the admin bar at the top

What you have now

  • A Nuxt app with the blog pages in app/pages/. Change them as you like. See Project structure.
  • The admin at /admin, with posts, media, and settings.
  • The posts in content/posts/, in your Git history.
  • Tags, categories and authors, each with its pages. See Tags and categories and Authors.
  • The SEO add-on, if you said yes to Add SEO?: SEO fields, sitemap.xml, robots.txt and feed.xml.
  • A content component, Callout, in app/components/content/. Add it to a post with the puzzle icon of the editor. See Components in posts.

The local sign-in and the local commits work in development only. To edit the posts on a live site, deploy it and connect GitHub. Pluto does the setup for you.

Deploy your site

Put the site online and edit it from anywhere.

Next steps

Change the design, add content types, or add a database.