Quickstart

Get from zero to fetching content in under five minutes.

1. Create a Noma account

Go to app.nomacms.com and create an account. Once you're in, you'll land on the project dashboard.

2. Create a project

Click New Project and give it a name. Every project gets its own isolated database, API, and settings. You can think of a project as one website, app, or product.

Once created, note the Project ID. You'll find it on the project home page or under Project Settings → API Access.

3. Get your API key

Go to User Settings → API Keys in the app sidebar and create a new API key. This key authenticates all SDK and API requests.

4. Create a collection

Inside your project, click New Collection and create one called "Posts" with slug posts. Add a few fields:

• title (Text)
• content (Rich Text)

Then create a couple of entries with some sample content. Save and publish them.

5. Install the SDK

npm install @nomacms/js-sdk

6. Set up environment variables

Add your credentials to .env.local (or your framework's env file):

NOMA_PROJECT_ID=your-project-uuid
NOMA_API_KEY=your-api-key

7. Fetch your content

import { createClient } from "@nomacms/js-sdk"
 
const noma = createClient({
  projectId: process.env.NOMA_PROJECT_ID,
  apiKey: process.env.NOMA_API_KEY,
})
 
// List all entries in the "posts" collection
const posts = await noma.content.list("posts")
console.log(posts)
 
// Get a single post by UUID
const post = await noma.content.get("posts", "entry-uuid-here")
console.log(post)

That's it. Your content is flowing from Noma into your application.

What's next

• Key Concepts - Understand projects, collections, fields, entries, and how they fit together.
• AI Code Editors - Set up Noma with Cursor, Claude Code, or other AI tools to build with natural language.
• JavaScript SDK - Full SDK reference with every method and option.
• Content API - Direct REST API reference if you prefer raw HTTP.