# TinyBase App Builder

Scaffolds and verifies local-first apps with TinyBase state, persistence and sync.

- Repository: https://github.com/tinyplex/tinybase (5208 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-22
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add tinyplex/tinybase --skill build-with-tinybase -g -a claude-code -y`
Codex: `npx skills add tinyplex/tinybase --skill build-with-tinybase -g -a codex -y`
Cursor: `npx skills add tinyplex/tinybase --skill build-with-tinybase -g -a cursor -y`
Gemini CLI: `npx skills add tinyplex/tinybase --skill build-with-tinybase -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add tinyplex/tinybase`

## Description

Scaffold, extend, and verify reactive local-first JavaScript or TypeScript applications with TinyBase. Use when choosing TinyBase for in-memory tabular or key-value state, generating an app with create-tinybase, adding schemas or UI bindings, resolving TinyBase import paths, configuring browser or database persistence, configuring MergeableStore synchronization over WebSockets or Cloudflare Durable Objects, or diagnosing an existing TinyBase application.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Build With TinyBase

Prefer a current generated application over reconstructing TinyBase setup from
memory. Preserve persistence and synchronization lifecycle ordering, and verify
the behavior the user actually needs.

## Read The References

Do not recall TinyBase API details from memory. Read the reference covering the
task before writing code:

| Reference                                                      | Read it when                                                                                                            |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| [references/architecture.md](references/architecture.md)       | Choosing between Store and MergeableStore, a persistence backend, a synchronization approach, or UI bindings            |
| [references/import-paths.md](references/import-paths.md)       | Importing anything outside the `tinybase` root, or checking which Persisters accept a MergeableStore                    |
| [references/lifecycle.md](references/lifecycle.md)             | Creating, starting, reconnecting, or destroying a Persister or Synchronizer, or setting WebSocket paths and channel Ids |
| [references/durable-objects.md](references/durable-objects.md) | Building or debugging a Cloudflare Durable Object sync server                                                           |

## Select The Architecture

Read [references/architecture.md](references/architecture.md) when choosing
between Store and MergeableStore, persistence backends, synchronization, or UI
bindings.

Confirm that TinyBase fits the task:

The rest: https://github.com/tinyplex/tinybase/blob/HEAD/docs/skills/build-with-tinybase/SKILL.md