Portable infrastructure · TypeScript
Infrastructure that tells you where its guarantees end.
Astilba builds portable infrastructure tools and libraries with explicit correctness boundaries. The documentation says what works, what it costs, and what remains incomplete.
create-astilba 0.3.0 is released · @astilba/env 0.3.0 is a public alpha · Cache remains a development preview
- Resolve react-vite-spa v2RECIPE
- Validate the complete planSAFE
- Write the staging treeSTAGE
- Publish the new destinationREADY
01 · Released product
Create
A deterministic CLI that creates an independent TypeScript repository with pinned tooling, verification, security workflows, and explicit ownership evidence.
| Guarantee | Boundary made visible |
|---|---|
| A complete plan is validated before Create publishes a destination. | Unsafe paths, collisions, link failures, and invalid metadata stop generation. |
| Recipes are maintained as whole projects. | The catalog stays small instead of exposing unverified feature combinations. |
| Ownership evidence travels with the repository. | The manifest records managed, seeded, structured, metadata, and linked output separately. |
02 · Public alpha
Env
A local-first TypeScript configuration contract compiler with explicit lifecycles and physically separated browser and server projections.
| Guarantee | Boundary made visible |
|---|---|
| Every value belongs to a declared lifecycle. | Build, deployment, and request values are resolved where they become available. |
| Browser exposure is an explicit projection. | Generated browser modules contain no private names, bindings, values, or full-contract metadata. |
| Runtime browser configuration stays inert. | The application owns a same-origin JSON endpoint and its cache, trust, and failure policy. |
03 · Development preview
Cache
A server-side TypeScript cache for applications that need explicit invalidation, classified stale-on-error resilience, privacy-aware sharing, and portable runtime adapters.
| Guarantee | Boundary made visible |
|---|---|
| Uncertain invalidation knowledge never becomes false freshness. | Cache may perform extra origin work while distributed state reconverges. |
| Identity is part of storage safety. | Principal-derived values stay local unless the application declares a shareable scope. |
| Portability is a capability boundary. | The raw constructor requires storage, a clock, and a random source from the runtime. |
04 · One public corpus
For people and agents
The same public documentation is available as readable pages, authored Markdown, and a bounded read-only MCP service.