strapi

Strapi

Strapi is an open-source, customizable headless CMS providing a powerful Document Service API, role-based access control, and customizable REST/GraphQL endpoints.

When to Use

• Self-Hosted Open Source Headless CMS: Complete ownership of content data, database schemas, and hosting infrastructure.
• Customizable Admin Dashboard: Building content management workflows for editorial and marketing teams.
• Automated REST & GraphQL Endpoints: Instantly exposing type-safe APIs for frontends (Next.js, Nuxt, mobile).
• Role-Based Content Governance: Granular permissions, internationalization (i18n), and draft/publish workflows.

Quick Start

# Create a new Strapi project with quickstart SQLite
npx create-strapi-app@latest my-cms --quickstart

// src/api/article/controllers/article.js
const { createCoreController } = require("@strapi/strapi").factories;

module.exports = createCoreController("api::article.article", ({ strapi }) => ({
  async findCustom(ctx) {
    const entries = await strapi.entityService.findMany(
      "api::article.article",
      {
        populate: ["author", "coverImage"],
      },
    );
    return ctx.send(entries);
  },
}));

Core Concepts

Content-Type Schema Definition

Declaring entities, attributes, and relationships via JSON schema:

{
  "kind": "collectionType",
  "collectionName": "articles",
  "info": {
    "singularName": "article",
    "pluralName": "articles",
    "displayName": "Article",
    "description": "Editorial blog articles"
  },
  "options": {
    "draftAndPublish": true
  },
  "attributes": {
    "title": {
      "type": "string",
      "required": true,
      "minLength": 5
    },
    "slug": {
      "type": "uid",
      "targetField": "title",
      "required": true
    },
    "content": {
      "type": "richtext"
    },
    "author": {
      "type": "relation",
      "relation": "manyToOne",
      "target": "plugin::users-permissions.user"
    }
  }
}