Kord
Kord: Versioned Content & Data Storage on Cloudflare Edge
A lightweight content and data storage platform focused on receiving and managing subtitles, prompts, notes, and structured data, with complete version history.
π Live Demo: https://kord.sedationh.top
Core Scenarios
1. Video Subtitle Archival
Save subtitle files with Canonical Keys to ensure one video only has one copy.
- Input
https://youtube.com/watch?v=dQw4w9WgXcQβ automatically parsed toyoutube:dQw4w9WgXcQ - Next time you save subtitles for the same video, it updates the same resource instead of creating duplicates
2. Text Version Evolution
Perfect for content that requires iterative refinement:
- Prompt tuning - Each modification creates an immutable snapshot
- Translation polishing - Roll back to any previous version anytime
- Draft auto-save - Real-time sync while editing
3. Structured Data Storage
Through the data: type, store JSON data for various lightweight storage scenarios:
| Key | Use Case | Example Data |
|---|---|---|
data:blog-stats | Blog likes count | {"likes": {"post-1": 42}} |
data:site-config | Site configuration | {"theme": "dark"} |
data:reading-list | Reading progress | [{"title": "Book", "progress": 0.5}] |
4. Workflow Integration
Open API via Personal Access Token (PAT) for AI Agents or automation workflows - serving as a versioned storage backend for your automation pipelines.
Architecture Design
Metadata-Blob Separation Architecture - distributing data across different Cloudflare components based on access frequency.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Cloudflare Edge β
β βββββββββββββββ βββββββββββββββ βββββββββββββββ β
β β D1 (SQL) β β KV (K/V) β β R2 (Blob) β β
β β Metadata β β Drafts β β Snapshots β β
β β Warm β β Hot β β Cold β β
β ββββββββ¬βββββββ ββββββββ¬βββββββ ββββββββ¬βββββββ β
β β β β β
β ββββββββββββββββββΌβββββββββββββββββ β
β β β
β βββββββββββ΄ββββββββββ β
β β Nuxt 3 (Nitro) β β
β β Edge Runtime β β
β βββββββββββ¬ββββββββββ β
ββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββ
β
ββββββββββ΄βββββββββ
β Client β
β (Vue 3 SPA) β
βββββββββββββββββββ
Data Tiering
| Tier | Storage | Purpose | Characteristics |
|---|---|---|---|
| Hot π₯ | KV | Current state | Real-time sync on every change |
| Warm π | D1 | Metadata & summaries | Fast list page queries |
| Cold βοΈ | R2 | Immutable snapshots | Frozen on commit |
Tech Stack
| Layer | Technology | Description |
|---|---|---|
| Full-stack Framework | Nuxt 3 | Vue 3 based full-stack framework |
| Server Engine | Nitro | Native Cloudflare Workers support, cold start <10ms |
| Metadata Layer | Cloudflare D1 | Edge SQLite for indexes, versions, tokens |
| Active Content Layer | Cloudflare KV | Low-latency key-value storage |
| Archive Layer | Cloudflare R2 | Object storage for immutable snapshots |
| ORM | Drizzle ORM | Edge-optimized, type-safe, zero runtime overhead |
Canonical Key System
All user inputs are normalized into canonical keys for deduplication:
| Input Type | Canonical Key | Content Format |
|---|---|---|
data:KEY | data:blog-stats | JSON |
| YouTube URL | youtube:VIDEO_ID | Markdown |
| Bilibili URL | bilibili:BVID | Markdown |
| Other URL | url:SHA256_HASH | Markdown |
| Custom note | note:SLUG | Markdown |
The same canonical key can only have one resource per user - achieving automatic deduplication.
Authentication
Dual-track authentication system balancing UI interaction and API automation:
1. UI Interaction (GitHub OAuth)
- Sealed Session Cookie with edge-local decryption
- No database query needed for verification
2. API Access (PAT)
- For AI Agents, CLI, and automation scripts
- Backend stores only SHA-256 hash, supports instant revocation
Key Features
- β Content & structured data storage with version control
- β Canonical key deduplication (YouTube, Bilibili, URLs, notes)
- β Dual-track authentication (OAuth + PAT)
- β Real-time draft auto-save
- β Edge deployment with global low latency
- β Responsive UI (mobile-friendly)
Kord serves as a lightweight, versioned storage backend - whether youβre archiving video subtitles, tuning AI prompts, or storing application data. Give it a try at kord.sedationh.top.