Capsium — Common architecture for portable secure information interchange and unified management
The elemental unit of web deployment.
One whole capsule for an entire website or webservice — self-contained, immutable, untampered: every byte integrity-checked before a single route is served. Capsium is the standardized contract between those who package and those who deploy. Package once. Serve anywhere.
The contract
One capsule, understood by every reactor
A .cap package is the standardized interface between the people who package and the people who deploy. Hover or tab through the diagram.
Reactors
The packager and the deployer never have to agree on a runtime — only on the contract inside the capsule.
Why Capsium
Whole, and provably untampered.
A capsule arrives exactly as it was packed. Every file is SHA-256-checksummed at pack time — a reactor that detects a single mismatch refuses to serve it.
A whole site in one capsule
Content, data, routes, and metadata encapsulated in a single .cap file — self-contained, immutable, tamper-evident to the last byte.
The contract
metadata, manifest, routes, storage, security — five JSON files every packager writes and every reactor reads.
Multilayer capsules
Packages stack as immutable overlay layers and declare dependencies — compose sites from capsules.
Deploy anywhere
The same file activates on Ruby, nginx/OpenResty, a browser extension, or a service worker. No rebuilds.
Works out of the box
Three commands to a served capsule
The Capsium CLI packs any directory into a verified .cap and serves it with the built-in Ruby reactor — no configuration, no runtime dependencies.
$ gem install capsiumInstall the CLI
$ capsium package pack -f my-site/Pack a directory into a .cap
$ capsium reactor serve my-site-1.0.0.capServe it with the Ruby reactor
Ecosystem
Packagers and reactors
An open-source family of tools that build Capsium packages and serve them on any platform.
Ready to pack your first capsule?
Install the Ruby gem, pack a directory, and serve it locally in under a minute.