Overview

This guide walks you through the complete workflow: creating an account, setting up your first blog, publishing a post, and embedding it in your .NET application using a Client SDK.

Step 1: Create Your Account

Visit the Postnomic website and click Sign Up. Complete the Auth0 registration flow and verify your email. You will start on the Free plan, which includes 1 blog, 5 posts per month, and 100 MB of storage.

Step 2: Create Your First Blog

From the dashboard, click Create Blog and fill in the details:

• Name — Your blog's display name (e.g., "My Dev Blog")
• Slug — A URL-friendly identifier (e.g., my-dev-blog). This is used in API calls and routing.
• Description — A short summary of what your blog is about.

Click Create and your blog is ready to go. You are automatically assigned the Admin role on this blog.

Step 3: Generate an API Key

Navigate to your blog's Settings → API Keys and click Create API Key. Give it a descriptive name like "Production Website". Copy the generated key — it will look like pk_your_blog_key_here. You will need this to connect your application.

Step 4: Write Your First Post

Go to Posts → New Post and create your content:

• Title — Your post's headline
• Slug — Auto-generated from the title, or set a custom one
• Content — Write your post using the Markdown editor
• Cover Image — Upload an image for the post header
• Excerpt — A short summary shown in blog listings

Set the status to Published and save.

Step 5: Integrate into Your Application

Choose the Client SDK that matches your project type.

ASP.NET Core Razor Pages

Install the NuGet package and configure it in Program.cs:

dotnet add package Postnomic.Client.AspNetCore

builder.Services.AddPostnomicBlog(options =>
{
    options.BaseUrl = "https://api.postnomic.com";
    options.ApiKey = "pk_your_blog_key_here";
    options.BlogSlug = "my-dev-blog";
});

Your blog is now accessible at /blog in your application.

Blazor (Server + WASM)

Install the NuGet package:

dotnet add package Postnomic.Client.Blazor

builder.Services.AddPostnomicBlog(options =>
{
    options.BaseUrl = "https://api.postnomic.com";
    options.ApiKey = "pk_your_blog_key_here";
    options.BlogSlug = "my-dev-blog";
});

Add the assembly reference in your App.razor:

<Router AppAssembly="typeof(Program).Assembly"
        AdditionalAssemblies="new[] { typeof(Postnomic.Client.Blazor._Imports).Assembly }">

Step 6: Verify

Run your application and navigate to /blog. You should see your blog listing with the post you just published. Click into the post to see the full content rendered with your application's layout.

Next Steps

• Customize the look — Override default CSS to match your brand
• Add team members — Invite authors and editors to collaborate
• Explore the API — Use the Scalar API docs for advanced integrations
• Upgrade your plan — Unlock more blogs, posts, and storage as you grow