# Ship in 5 minutes

> Create a project, draft a post, and publish your first article.

HTML version: https://blogizi.com/docs/quick-start
Markdown version: https://blogizi.com/docs/quick-start.md

This walkthrough gets you from zero to a live blog post in a few steps.

## 1. Create an account

Sign in at [blogizi.com/sign-in](/sign-in) with Google or a magic link. You'll land in the dashboard.

## 2. Create a project

Click **New project**, pick a slug (this becomes your subdomain), and optionally link your GitHub repo URL.

Your blog will be live at `https://your-slug.app.blogizi.com` as soon as you publish a post.

## 3. Copy your API key

Open **Dashboard → Account → API** (or any project **Settings → API**) and copy your account API key. One key covers all your projects.

## 4. Install & authenticate the CLI

```sh
npm install -g blogizi
blogizi auth YOUR_API_KEY
blogizi use your-project-slug   # required if you have more than one project
```

## 5. Write and publish

Write a markdown file with Blogizi frontmatter (yourself or with an AI coding agent), then from your project directory:

```sh
blogizi draft path/to/how-we-built-our-auth-flow.md
blogizi publish path/to/how-we-built-our-auth-flow.md
```

See [Write in Markdown](/docs/markdown-frontmatter) for the frontmatter format.

Visit your subdomain to see the post live. Next, configure [a custom domain](/docs/custom-domain) or [path mode](/docs/path-mode) if you want the blog on your main site.
