Skip to main content

​
Quickstart Guide

Get up and running with Blog Marketing Platform in just a few minutes. This guide will walk you through creating an account, exploring the dashboard, and publishing your first blog post.

​
Prerequisites

Before you begin, make sure you have:
  • A modern web browser (Chrome, Firefox, Safari, or Edge)
  • An email address for account registration
  • (Optional) Backend API running at http://localhost:3000/api/v1
The platform can run in mock mode without a backend, perfect for testing and development.

​
Step 1: Create Your Account

Start by registering for a new account.
1

Navigate to Registration

Open your browser and go to the registration page at /auth/register.
2

Fill Out Registration Form

Enter your information:
  • First Name: Your first name
  • Last Name: Your last name
  • Email: Your email address (must be unique)
  • Password: A strong password (min. 8 characters)
  • Confirm Password: Re-enter your password
const userData = {
  firstName: 'John',
  lastName: 'Doe',
  email: '[email protected]',
  password: 'SecurePass123!',
  confirmPassword: 'SecurePass123!',
  acceptTerms: true
};
3

Accept Terms

Check the box to accept the Terms and Conditions and Privacy Policy.
4

Submit Registration

Click the “Create Account” button. The system will:
  • Validate your email is available (you’ll see a green checkmark)
  • Create your account with the “Author” role by default
  • Automatically log you in
  • Redirect you to the onboarding flow
Email Validation: The platform checks email availability in real-time as you type, showing a green checkmark when available or a red X if already taken.

​
Default User Role

New users are automatically assigned the Author role (⏳) with these permissions:
  • Create and edit your own posts
  • Comment on published content
  • React to posts and comments
  • Submit posts for editorial review

​
Step 2: Complete Onboarding

After registration, you’ll see a welcome onboarding flow that introduces you to the platform’s key features.
  • Interactive tour of the admin dashboard
  • Overview of the post creation wizard
  • Introduction to categories and keywords
  • Tips for your first blog post

​
Step 3: Explore the Dashboard

Once logged in, you’ll land on your personalized dashboard: 
// The dashboard shows different content based on your role
const dashboardViews = {
  creator: 'Full analytics, user management, all posts',
  admin: 'Analytics, user management, content moderation',
  editor: 'Content overview, pending posts, categories',
  writer: 'Your posts, drafts, analytics for your content',
  author: 'Your posts, drafts, analytics for your content',
  commenter: 'Recent posts, your comments, activity feed'
};

​
Dashboard Components

Stats Cards

View your key metrics: total posts, published count, total views, and engagement.

Recent Posts

Quick access to your recently created or edited posts.

Activity Feed

See recent actions and updates from your team.

Quick Actions

One-click access to create posts, manage categories, and more.

​
Step 4: Create Your First Post

Now let’s create your first blog post using the intuitive post creation wizard.
1

Open Post Creation Wizard

Click the “Create Post” button or use the quick action menu. The wizard has 4 steps:
  1. Basic Information - Title, category, excerpt
  2. Content - Write your article
  3. SEO - Meta tags and keywords
  4. Publication - Publish or schedule
2

Step 1: Basic Information

Fill in the essential details:
const postData = {
  title: 'Getting Started with Content Marketing',
  categoryId: '1', // Select from available categories
  excerpt: 'Learn the fundamentals of content marketing and how to create engaging blog posts that drive results.',
  tags: ['marketing', 'content', 'beginner']
};
  • Title: Your post headline (required)
  • Category: Select from existing categories (required)
  • Excerpt: A brief summary (shown in post listings)
  • Tags: Add relevant tags for organization
3

Step 2: Write Content

Use the built-in MDX editor to write your content:
Example Content
# Introduction

Content marketing is essential for modern businesses. In this guide, we'll explore:

- Why content marketing matters
- How to create compelling content
- Best practices for SEO

## Key Principles

1. **Know Your Audience**: Understand who you're writing for
2. **Provide Value**: Every post should solve a problem
3. **Be Consistent**: Regular publishing builds trust

> "Content is king, but engagement is queen, and the lady rules the house." - Mari Smith
The editor supports:
  • Markdown formatting (headings, lists, quotes)
  • Code blocks with syntax highlighting
  • Images and media embeds
  • Real-time preview
4

Step 3: SEO Optimization

Optimize your post for search engines:
const seoData = {
  metaTitle: 'Getting Started with Content Marketing | Your Blog',
  metaDescription: 'Learn content marketing fundamentals, best practices, and strategies to create engaging blog posts that drive traffic and conversions.',
  focusKeyword: 'content marketing'
};
  • Meta Title: SEO-friendly title (50-60 chars)
  • Meta Description: Search result snippet (150-160 chars)
  • Focus Keyword: Primary keyword for this post
5

Step 4: Publish Settings

Configure how your post will be published:
const publishSettings = {
  status: 'published', // or 'draft', 'pending', 'scheduled'
  allowComments: true,
  featured: false, // Pin to homepage
  notifySubscribers: true,
  publishDate: new Date() // or future date for scheduling
};
Status Options:
  • Draft: Save without publishing (visible only to you)
  • Pending: Submit for editorial review
  • Published: Publish immediately (if you have permission)
  • Scheduled: Publish at a specific date/time
6

Submit Your Post

Click “Publish Post” or “Save as Draft”. The system will:
  • Validate all required fields
  • Save your content
  • Generate a unique slug from your title
  • Send notifications (if applicable)
  • Redirect you to your post or posts list
Permission Check: Authors and Writers submit posts as “Pending” by default. Editors and Admins can publish directly.

​
Step 5: View Your Published Post

Once published, your post is live! You can:
  • View it on the public blog
  • Share it via the share button
  • Edit it from your posts dashboard
  • Track analytics to see views and engagement
// Example post URL structure
const postUrl = `/blog/${post.slug}`;
// e.g., /blog/getting-started-with-content-marketing

​
Understanding Post States

Your posts can have different states based on your role and actions:
  • Draft: Work in progress, visible only to you
  • Pending: Submitted for editorial review
  • Published: Live on your blog
  • Scheduled: Will publish at specified date/time
  • Rejected: Returned by editor with feedback
  • Archived: Removed from public view but kept for reference

​
Next Steps

Congratulations! You’ve created your first post. Here’s what to explore next:

Post Management

Learn to edit, organize, and optimize your existing posts.

Categories & Tags

Organize your content with categories and tags.

Analytics

Track performance and understand your audience.

Team Collaboration

Work with editors and other team members.

​
Common Tasks

​
Edit an Existing Post

// Navigate to your posts list
// Click on any post to edit
// Or use the quick edit button

import { updatePost } from './services/postsService';

const handleUpdate = async (postId: number, updates: Partial<Post>) => {
  await updatePost(postId, updates);
};

​
Add Categories

As an Editor or Admin, you can create new categories: 
import { createCategory } from './services/categoriesService';

const newCategory = await createCategory({
  name: 'Product Updates',
  slug: 'product-updates',
  description: 'Latest product news and feature releases',
  isActive: true
});

​
Manage Comments

Monitor and moderate comments on your posts: 
import { moderateComment } from './services/commentsService';

// Approve or reject comments
await moderateComment(commentId, {
  status: 'approved', // or 'rejected'
  moderatorNotes: 'Looks good!'
});

​
Getting Help

Need assistance? Check out our comprehensive documentation or reach out to your admin for role-specific questions.

​
Useful Resources

​
Tips for Success

  1. Start with Drafts: Don’t worry about perfection - save drafts and refine later
  2. Use Categories: Organize content from the start for better navigation
  3. Focus on SEO: Fill out meta descriptions and use focus keywords
  4. Engage with Comments: Respond to readers to build community
  5. Check Analytics: Learn what content resonates with your audience
You’re all set! Start creating amazing content with Blog Marketing Platform.

Build docs developers (and LLMs) love

Get started for freeTalk to us