OSS探訪

editor dashboardとREST APIを分け、任意frontendへcontentを配信する

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
384
主要言語
TypeScript
ライセンス
AGPL-3.0
リポジトリ最終更新
2026/09/29
ページ内ナビ

概要

Marbleはシンプルさを重視したheadless CMSで、Next.jsのeditor dashboardとHono REST APIを分離しています。postにauthor、category、tag、custom fieldを持たせ、任意のfrontendやTypeScript SDKからcontentを取得できます。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日:

主な特徴

REST APIでfrontendに依存せずcontentを配信する

CMS dashboardで編集したcontentをREST APIから取得できるため、Next.jsに限らず任意のsite/applicationへ組み込めます。

出典:[2][3]

editor・API・DBをmonorepoで分離する

apps/cmsはNext.js、apps/apiはHono、packages/dbはdatabase schema/clientという構成で責務を分けています。

出典:[3]

local Postgres/Redisとhosted serviceを選択できる

PostgreSQLはNeonまたはlocal Docker、RedisはUpstashまたはlocal Redis bridgeを使えるため、development時に依存serviceを置き換えられます。

出典:[3]

向いている用途

frontendを自由に選びつつ軽量なeditor体験とcontent APIが欲しい場合に向く

traditional CMSのtheme/runtimeへfrontendを縛らず、API-firstでblogやcontent siteを組みたいteamの候補です。

出典:[2]

導入前の確認

local起動にはOAuth・R2・Redis等の設定が必要

Google/GitHub OAuth、BetterAuth secret、Cloudflare R2、Postgres、Redisを設定する必要があり、DB containerだけ起動すれば全機能が動く構成ではありません。

出典:[3]

local default credentialをproductionへ流用しない

Docker local DB/Redisのguideにはdevelopment専用credentialが記載されています。productionではhosted/self-hostを問わず専用secretへ置き換えます。

出典:[3]

GitHub Releasesは未発行なのでcommit/version運用を自分で固定する

2026-10-01時点でGitHub Releasesは公開されていません。productionへ導入する場合はcommit SHAや自社tagでversionを固定し、upgrade手順を管理します。

出典:[1]

参考にした公式資料

  1. [1]usemarble/marble repository(2026-10-01)
  2. [2]Marble README(2026-10-01)
  3. [3]Marble contributing and local setup guide(2026-10-01)
  4. [4]Marble package.json(2026-10-01)
  5. [5]Marble AGPL-3.0 license(2026-10-01)
編集部からの補足

content editor向けdashboardとdelivery APIを分け、任意frontendからREST APIでpost・author・category・tag・custom fieldへアクセスするheadless CMSです。local開発にはPostgres/Redisに加えてOAuthとR2設定が必要で、単一containerだけで完結する構成ではありません。

3ステップで試す

  1. 1

    Marbleを取得して依存関係を導入

    Node.js 22系とpnpm 12.6.0の環境で公式repositoryを取得し、monorepo dependenciesを導入します。

    git clone https://github.com/usemarble/marble.git && cd marble && pnpm install
  2. 2

    envとlocal databaseを準備

    local Postgres/Redisを起動してmigrationを適用します。次のstep前にOAuth、BetterAuth、Cloudflare R2等の必要な環境変数を設定してください。

    cp apps/api/.env.example apps/api/.env && cp apps/cms/.env.example apps/cms/.env && cp apps/web/.env.example apps/web/.env && cp packages/db/.env.example packages/db/.env && pnpm docker:up && pnpm db:migrate
  3. 3

    development environmentを起動

    CMS、API、webなどのworkspaceをdevelopment modeで起動します。必要なappだけならpnpm cms:devやpnpm api:devも利用できます。

    pnpm dev
公式READMEで確認

成長

成長の推移 · 直近30日

384 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit(直近30日)
46
Open PR
0

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHub Topics

  • cms
  • cms-backend
  • cms-framework
  • headless
  • headless-cms
  • marble
Stars
384
Forks
54
Watchers
1
Open Issues
0
Contributors
31
所有者種別
Organization
主要言語
TypeScript
ライセンス
AGPL-3.0
リポジトリ最終更新
2026/09/29

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。

このページを読んで、次に何をすればよいか分かりましたか?