Getting Started

What is Kookee?

Updated 83 views

Kookee is a content management API for developers. Your team writes content in the Kookee dashboard; your application fetches it through a typed SDK or a REST API. Nothing in between requires a deploy.

The modules

One project gives you seven content surfaces:

  • Blog — posts with tags, search and emoji reactions

  • Changelog — versioned entries typed as feature, fix, improvement, breaking, security, deprecated or other

  • Help Center — articles with categories, semantic search and an AI chat widget

  • Pages — static pages such as Terms, Privacy and About

  • Config — key-value configuration and feature flags

  • Announcements — in-app notifications with scheduling

  • Feedback — a board where users post, vote and comment, which also powers a public roadmap, plus private messages sent from the site widget for your team to review

Every project can also enable a hosted public portal — a ready-made page with all of these modules already built, if you would rather not build a frontend at all.

How it works

  1. Create a project in the dashboard at kookee.dev

  2. Add content using the visual editor

  3. Fetch it with the SDK or the REST API

TypeScript
import { Kookee } from '@kookee/sdk';

const kookee = new Kookee({ apiKey: process.env.KOOKEE_API_KEY! });

const posts = await kookee.blog.list();
const articles = await kookee.help.list();
const config = await kookee.config.getByKey('feature-new-dashboard');

What you get

  • TypeScript-first — the SDK is zero-dependency and fully typed

  • React components — server-rendered blog, changelog, help center, roadmap and status pages you can drop in and restyle, and an announcement pill with its list

  • Multi-language — per-locale entries with automatic fallback to your default locale

  • Instant updates — published changes are available over the API immediately

  • A site widget for any site — one script tag, with an AI assistant that answers from your published help articles, your news and help center, and a feedback form

  • A status page and uptime monitors — the status of your services, incidents and scheduled maintenance on a page Kookee hosts, and checks of your site that alert your team when it goes down

  • Engagement built in — reactions on posts and changelog entries, votes and comments on feedback

  • A dashboard non-engineers can use — writers do not need your repository

What Kookee is not

Kookee does not build your site for you, unless you use the hosted portal. The API returns JSON with an HTML content body, and your application decides how it looks, with markup of your own or with the ready-made React components. It is also not a general-purpose application database — it is for the content around your product, not the data inside it.

Next steps

  • Creating your first project — set up a project and generate an API key

  • Your first API call — fetch content in under five minutes

  • Installing the SDK — add @kookee/sdk to your project

  • React components for your blog, changelog and help center — ready-made pages for React apps

  • Install the site widget on your website — one script tag, no code

Was this article helpful?