@spooky-sync/cli

The Reactive, Local-First Framework for SurrealDB

Under active development — not production-ready. APIs may change without notice.

Documentation · Example App · CLI · Contributing

Features

• Live Queries — Your UI updates instantly when data changes
• Local-First — Works offline using IndexedDB, syncs when back online
• End-to-End Type Safety — Generated TypeScript definitions from your SQL schema
• Optimistic UI — Immediate feedback for user actions while syncing in the background

Quick Start

Install

pnpm add @spooky-sync/client-solid

Generate Types with CLI

npx @spooky-sync/cli generate

Usage (SolidJS)

import { useQuery } from '@spooky-sync/client-solid';
import { db } from './db';

const ThreadList = () => {
  const threads = useQuery(() => db.query('thread').select('*').all());

  return (
    <ul>
      <For each={threads.data}>{(thread) => <li>{thread.title}</li>}</For>
    </ul>
  );
};

Packages

Example App

Check out the full-featured reference app built with SolidJS:

cd example/app-solid && pnpm install && pnpm dev

Documentation

Full documentation is available at mono424.github.io/sp00ky.

• Secrets in migrations — inject vault secrets into schema via {{KEY}} placeholders, and spky env set --file.

Contributing

Contributions are welcome! This is a monorepo — see the individual package directories under packages/ for details.

License

MIT

Star History