Next-Blog-AI
Home/Documentation/Getting Started/Quickstart
Back to Documentation

Quickstart Guide

From zero to a live, AI-powered blog in about 5 minutes.

Next-Blog-AI uses a guided setup wizard that walks you through everything — from analyzing your website to publishing your first blog post.

Estimated time: ~5 minutes

What the wizard does

8 guided steps — each one builds on the last.

1.Analyze site

2.Review details

3.Competitors

4.Keywords

5.Topics

6.First post

7.Install

8.Test

📖 Step-by-Step Guide

The setup wizard takes care of the heavy lifting. Here's what to expect at each step.

Before you start

  • A Next.js project (App Router) — new or existing
  • Node.js 14.x or higher
  • A Next-Blog-AI account (free tier works)
1

Enter Your Website URL

From your dashboard, click New Website Project to start the setup wizard.

  • Paste your website URL
  • The wizard automatically analyzes your site — detecting your industry, target audience, product description, features, and more
  • Initial SEO keywords are generated from the analysis

The AI analysis takes about 15–30 seconds. Everything it detects is editable in the next step.

2

Review Project Details

The wizard pre-fills your project details based on the analysis. Review and edit anything that needs adjusting:

  • Project name — auto-generated from your domain
  • Industry & audience — detected from your site content
  • Product description — summarized from your site
  • Blog path — where your blog will live (defaults to /blog)
  • Language — defaults to English, supports 6 languages
  • Publisher name — the author name shown on posts
3

Add Competitors

Optional
  • Add up to 5 competitor website URLs
  • The wizard analyzes their content and extracts high-value SEO keywords
  • Competitor keywords are merged with your AI-generated keywords automatically

This step is optional but highly recommended — competitor analysis significantly improves keyword targeting.

4

Review Keywords

Your keywords are already populated from the website analysis and competitor research. You can:

  • See all keywords color-coded by source (AI-generated, competitor, manual)
  • Remove any keywords that aren't relevant
  • Add your own keywords manually

At least one keyword is required to proceed. These keywords drive all generated content.

5

Choose Topics

Optional

You have two choices here:

  • Generate automatically — skip this step and let the AI pick the best topics based on your keywords
  • Add your own — specify topics you want posts about, or use AI suggestions as a starting point
6

Preview Your First Post

The wizard generates your first SEO-optimized blog post using everything collected so far — your website context, keywords, and topics.

  • Your project and API key are created automatically at this stage
  • Preview the post with stats like reading time, word count, and SEO score
  • This is a preview — you can edit or regenerate the post anytime from your dashboard

Project Created & First Post Ready

At this point your project is live, your API key is generated, and your first blog post is published. Now the wizard guides you through installing it in your Next.js app.

7

Install in Your Next.js Project

The wizard provides your API key and installation instructions. The recommended approach is the CLI:

npx create-next-blog-ai@latest

The CLI prompts you for your API key and blog path, then automatically creates all the necessary files:

app/blog/ # Blog route (or your custom path) ├── page.tsx # Blog list page ├── layout.tsx # Blog layout └── [id]/ └── page.tsx # Blog post detail page lib/ └── blog-api.ts # API client setup app/ └── sitemap.ts # Dynamic sitemap for SEO

Your API key is shown in the wizard with a copy button. Add it to your .env.local and never commit it to version control.

Prefer manual setup? The wizard also includes a Manual tab with step-by-step code snippets. See the Advanced Setup guide for more details.

8

Verify It Works

The final step asks you to confirm everything is working. Start your dev server and check:

  1. Blog route files exist in your project (e.g. app/blog/page.tsx)
  2. The blog list page loads and shows your first post
  3. Clicking the post opens the full detail page
  4. /sitemap.xml includes your blog URLs

If something isn't right, the wizard provides an interactive troubleshooting checklist to help you diagnose and fix the issue.

Once confirmed, you're taken to your project dashboard where you can set up a content schedule, manage keywords, and style your blog.

🎉 That's it!

Your AI-powered blog is live. Content is generated, SEO is handled, and your Next.js app is serving blog posts. Head to your project dashboard to set up a content schedule and keep posts publishing automatically.