InstanceIO Framework
About
What is InstanceIO?
A hybrid PHP framework for static or dynamic websites. HTMx-ready and Docker-ready out of the box. Exports to flat-file HTML for S3, serverless functions, or IPFS.
Capabilities
Components
PHP classes + HTML templates + CSS. Compose and extend infinitely.
HTMx
Server-driven UI updates. No JS framework required.
Docker
Dev and prod containers. Dynamic or static builds.
Static Export
Compile to flat HTML with one command.
API Integration
Ingest .iio templates from any endpoint.
CLI
Generate components, controllers, routes from the terminal.
Architecture
Agent-based architecture where each agent handles a specific responsibility:
Kernel
Application bootstrap and orchestration
Routes
HTTP request routing (web + API)
Controllers
Request handling and response preparation
Components
Reusable UI element rendering
Repositories
Data access and view management
Services
External API integration
Views
Template rendering and variable injection
Use Cases
Static sites
Marketing, portfolios, docs — export to HTML
Dynamic apps
Server-side rendering with HTMx partial updates
API-driven
Consume external APIs, render components with remote data
Decentralized
Pin to IPFS for censorship-resistant hosting
Getting Started
Install the IIO package into your project:
php install.phpRequires the IIO package in a directory one level above the app root: ./../iio. Pull from the official repository.
Links
Start building
Install the framework and scaffold your first component in under a minute.