Plaintextdocs
Search the docs…⌘K
v2.4 12.3k
DocsGetting startedInstallation

Installation

A flat-file content engine that reads like a printout and ships like code. Install the client, configure a single object, and start making fully-typed requests. Everything below is copy-paste ready — no scaffolding required.

Requires Node 18+

The runtime ships native ESM and the Fetch API. For older environments, pull in a polyfill before importing the client.

npmpnpmyarnbun
terminalbash
1$ npm install @plaintext/core

Configuration

Create a client once and reuse it across your app. The configuration object is fully typed; your editor will autocomplete every field.

client.tstypescript
1import { createClient } from "@plaintext/core"
2 
3const client = createClient({
4 apiKey: process.env.API_KEY,
5 region: "us-east",
6 timeout: 5000,
7})
8 
9const { data } = await client.query("projects")

Parameters

NameTypeDefaultDescription
apiKeystringSecret key used to authenticate every request.
region"us-east" | "eu""us-east"Edge region the client routes traffic through.
timeoutnumber10000Per-request timeout in milliseconds.
retriesnumber2Automatic retry count for idempotent calls.
cachebooleantrueEnable the in-memory response cache.

Response shape

Every successful call resolves to a discriminated union you can narrow safely:

response.jsonjson
1{
2 "ok": true,
3 "count": 3,
4 "data": [
5 { "id": "prj_8fa2", "name": "Atlas" }
6 ]
7}
Keep going

Guides

Hand-written walkthroughs for the most common things you’ll build with Plaintext.

Author in Markdown

Drop .md files into a folder and Plaintext compiles them into a typed content tree — no database, no admin panel, just text on disk.

Read guide

Query the tree

Filter, sort, and join your documents with a small fluent API that returns plain objects you can render anywhere.

Read guide

Ship to the edge

Run `plaintext build` to emit a static index and serve it from any CDN — every page resolves in a single lookup.

Read guide
plaintext — zsh
$plaintext init my-app
✓ scaffolding project
✓ installing dependencies
ready · http://localhost:3000
$plaintext deploy --prod
› building 4 routes
deployed in 8.2s → atlas.app
$
Plaintext

A flat-file content engine that reads like a printout and ships like code.

DocsQuickstartGuidesAPI referenceExamples
ResourcesChangelogStatusRoadmapDiscord
CompanyBlogCareersSecurityContact
© 2026 Plaintext — an original demo built in the Mono style for staqd. MIT licensed. v2.4.0 · build 8fa2c3e · node 20.11