Canonical definition
Ordinary files your apps and agents can use. One path from local data to deployed applications and shared work.
What we are building for
Your app already keeps data in files. Every new project rebuilds parsing, validation, queries and safe updates.
For exampleA small app with JSON tasks, Markdown notes and original PDF attachments.
A shared record schema and field queries are the next step; they are not in the released Core yet.
A deployed app needs its data to survive restarts and stay consistent across application instances.
For exampleTwo app instances read and update the same customer brief after either instance restarts.
The goal is one shared data contract and a durable remote API. Hosted database access is not available yet.
A teammate, an agent and another device need the same work without silently replacing each other’s edits.
For exampleA teammate edits a note while an agent works offline, then both changes return for resolution.
Reader/editor access and explicit synchronization are planned. The local preview does not provide a shared sync service.
Folderbase does not import files into a proprietary container. Documents, repositories, media, spreadsheets, PDFs, databases, archives, and unknown formats keep their ordinary paths and native tools. The protocol layer describes and coordinates the work without taking ownership of its bytes.
Inspect, preview, and initialize an ordinary folder with the additive .folderbase protocol layer.
Explore setupCompare the agent’s proposal with its starting version and the current files. Check the released capability and known new-file apply limitation before using the workflow.
Read the review guideThe Cloud direction is shared, durable data for deployed clients, followed by permissioned access and explicit synchronization. Bring your own app and agent runtime.
Read the continuity guideThe public Apache-2.0 protocol, Rust engine, CLI, templates, schemas, sync primitives, and conformance surface. Local use requires no Folderbase account.
A macOS app in development for inspecting ordinary files and reviewing proposed agent changes. The complete new-file apply workflow is blocked in Core 0.7.2.
A service in development for durable deployed app data, followed by shared access and explicit replica synchronization. These hosted features are not available yet.
Use your existing agent runtime and model account. Hosted agent compute is outside the current MVP.
Folderbase Database Core is the protocol and runtime authority beneath the commercial App and managed Cloud. The public repository contains the Rust Core, CLI, schemas, templates, conformance fixtures, and architecture decisions.
Folderbase currently provides a local file-storage foundation with identity, versions and metadata queries. A shared JSON/Markdown application schema, field queries, deployed access and durable sync are the next product steps.
The Folderbase Database Core, CLI, protocol, schemas, templates, and conformance surface are public under Apache-2.0. App and Cloud workflows remain in development. Hosted agent compute is outside the current MVP.
Keep the tools that fit your workflow. Folderbase evaluates an open workspace layer around existing files. Its managed remote workflow is still in development.
Yes. The open Core works locally without an account. Cloud remains an optional pilot conversation; local initialization does not activate or upload to a hosted service.
Try the local quickstart today. Discuss your app’s deployed data, sharing or synchronization needs as we develop the Cloud pilot.