Why does the format use deterministic serialization?

Deterministic serialization ensures that the same input always results in the same file output by sorting object keys alphabetically and avoiding random IDs, which is crucial for file comparison and version control.

What is the structure of a .boardkit file?

A .boardkit file is a ZIP archive containing two primary files: package.json for metadata and format versioning, and board.json for the actual document content and elements.

How are version migrations handled in Boardkit?

Migrations are handled through specific functions that transform the document structure from one version to another (e.g., v0 to v1), ensuring backward compatibility as new features are added.

What storage implementations are supported?

The format is designed for both Web environments using IndexedDB with debounced autosave and Desktop environments using Tauri for atomic file system writes.

Boardkit File Format

Name: Boardkit File Format
Author: kevinbarfleur

bykevinbarfleur

Database Management

Manages the .boardkit file structure, document serialization, and versioning for board-based applications.

About

This skill provides Claude with the technical specifications and implementation patterns for the .boardkit file format, a ZIP-based archive used for document persistence. It covers the internal structure of package.json and board.json, deterministic serialization rules, and version migration paths. It is an essential resource for developers working on the Boardkit ecosystem, enabling the AI to assist with building robust import/export systems, handling atomic writes on desktop, and managing IndexedDB transactions on the web.

Key Features

0 GitHub stars
ZIP-based archive structure specification
Deterministic serialization for consistent output
Versioned schema management and migration paths
Web (IndexedDB) and Desktop (Tauri) storage patterns
File validation and integrity check requirements

Use Cases

Developing backward-compatible migrations between board versions
Building schema-compliant import/export utilities for web platforms
Implementing atomic write operations for desktop board files

About

Key Features

0 GitHub stars
ZIP-based archive structure specification
Deterministic serialization for consistent output
Versioned schema management and migration paths
Web (IndexedDB) and Desktop (Tauri) storage patterns
File validation and integrity check requirements

Use Cases

Developing backward-compatible migrations between board versions
Building schema-compliant import/export utilities for web platforms
Implementing atomic write operations for desktop board files