Introduction

Welcome to the Noma documentation

Noma is an AI-native, API-first content delivery platform. It gives you structured content modeling, a powerful REST API, built-in AI workflows, project-scoped authentication, and seamless integration with modern frameworks and AI tools.

This documentation covers everything you need to build with Noma, from creating your first project to integrating content into your frontend.

Platform overview

Noma is built for developers and teams who need structured content delivered through APIs. Rather than a traditional CMS that couples content with presentation, Noma keeps your content in a clean, structured layer that your application consumes through its API or SDK.

Dashboard

The Noma dashboard at app.nomacms.com is where you manage projects, model content schemas, create and edit entries, upload assets, and configure project settings.

Content API

Every project gets a RESTful API secured by API keys. The API supports full CRUD operations on collections, fields, content entries, and assets, plus advanced filtering, pagination, bulk operations, and localization.

JavaScript SDK

The @nomacms/js-sdk package wraps the Content API in a typed, ergonomic client. It sends API keys on CMS routes, maps errors to typed exceptions, optional project user auth (with refresh), and exposes grouped methods for each resource.

npm install @nomacms/js-sdk

import { createClient } from "@nomacms/js-sdk"
 
const noma = createClient({
  projectId: process.env.NOMA_PROJECT_ID,
  apiKey: process.env.NOMA_API_KEY,
})
 
const entries = await noma.content.list("posts")

MCP Server

The @nomacms/mcp-server connects AI tools like Cursor, Claude Code, and Windsurf directly to your Noma project. It exposes 33 tools covering project, collection, field, content, asset, and webhook management, letting you manage your CMS through natural language.

Agent Skills

The Noma Agent Skills package provides specialized knowledge packs for AI coding assistants. Install them so your agent understands the SDK patterns, auth contracts, framework integrations, and best practices without you needing to explain them every time.

Key capabilities

Structured content modeling

Design your content schema with collections and custom fields. Noma supports 16 field types (text, rich text, number, boolean, date, media, JSON, relation, group, and more). Collections can be configured as lists (blog posts, products) or singletons (homepage, settings).

AI-powered workflows

• AI Assistant - A chat-based assistant that can create projects, build collections, manage entries, and navigate the CMS through conversation.
• Inline content tools - Generate, rewrite, expand, summarize, fix grammar, and translate text directly in any text or rich text field.
• AI translation - Translate entire content entries to another locale with one click, preserving formatting and linking translations automatically.

Project authentication

Noma provides built-in authentication for your end users. Sign up with email/password, sign in with social providers (Google, GitHub, etc. via id_token), manage sessions, and issue user-scoped API keys. Everything is project-scoped and managed through the API or SDK.

Asset management

Upload, organize, and serve files and images through the asset library. Assets support metadata, filtering by type or date, and bulk operations. Media URLs are served from your project's public endpoint.

Webhooks

Get notified when content changes. Configure webhook endpoints, choose which events to listen for, and inspect delivery logs. Payloads are signed for security.

Localization

Manage multilingual content with project-level locale configuration. Add locales, set a default, and link translated entries together for a seamless multilingual workflow.

Quick links

• Quickstart - Create a project and fetch your first content in minutes.
• JavaScript SDK - Install and configure the SDK for your application.
• Content API - Full API reference with authentication, endpoints, and examples.
• Project Auth - Set up user authentication for your application.
• MCP Server - Connect your AI coding tools to Noma.
• Framework Guides - Step-by-step integration with Next.js, Nuxt, and Astro.