Skip to main content

AppCore Runtime

AppCore is a Rust runtime for applications whose infrastructure must be explicit: manifests, lifecycle, command dispatch, storage boundaries, synchronization, provider selection, peer communication, supervision, and update activation are runtime responsibilities rather than application boilerplate.

This manual is written as a technical book. Read the chapters in order if you are new to the project:

  1. What AppCore is
  2. The three-artifact contract
  3. Bootstrap and runtime host
  4. Storage, DNT, backup, and restore
  5. Synchronization, logs, checkpoints, and replay
  6. Distributed operation
  7. Supervisor and lifecycle
  8. Performance budgets
  9. Updates
  10. Security model
  11. Build the first application
  12. Examples from basic to intermediate
  13. Reference for the stable crates and published previews
  14. Future roadmap

Stable release: 1.0.0. The current source catalog contains 28 active public crates with independent versions and explicit maturity. Minimum Rust toolchain: 1.89. New application code starts with appcore-sdk; lower-level crates remain available when their owning contract is needed directly. Consult each crate page before assuming that a source prerelease has been published.

Stable V1 is a compatibility promise, not a repository-wide feature freeze. AppCore may continue to add generic Runtime capabilities and independently versioned crates while existing V1 contracts remain coherent; incompatible contracts require a new explicit version.

What's Next​

The future roadmap tracks planned work without mixing it into the current Runtime reference. Current prerelease work includes appcore-ai, appcore-filemaker, and appcore-sync-sqlite; the current design preview is appcore-ui. High-priority planned areas include appcore-test, appcore-jobs, appcore-search, appcore-automation and appcore-plugin; see the Future Roadmap.

Limitations​

This index is a reading map, not an API reference. Use the chapter pages for operational behavior, trade-offs, and unsupported cases.