RCMV

RCMV is a small, folder-enforced web framework built on the Web Request and Response standards.

Request → Route → Controller → Model
                    ↓
                  View → Response

Its purpose is organizational clarity: a developer or specialized agent can change one responsibility without reconstructing the application around it.

Create an app

npx @rcmv/rcmv create my-app
cd my-app
npm install
npm run dev

The 0.1.2 starter uses Vite and Tailwind CSS for its View build and targets Cloudflare Workers. The framework core itself has no runtime dependencies and uses portable Web APIs.

For a reproducible build, pin the creator with npx @rcmv/[email protected] create my-app.

Folder contract

src/
├── routes/       # Request matching and wiring
├── controllers/  # Use-case orchestration
├── models/       # Data access and normalized results
├── views/        # HTML or API representation
└── index.ts      # Application composition

Each responsibility has its own AGENTS.md. These are boundary instructions placed beside the work; there is no separate agents layer.

Framework API

• defineRoute() declares a method, path, controller, and view.
• createApp() creates a standards-compatible { fetch() } application.
• model provides normalized data outcomes.
• controller provides normalized presentation outcomes.

Parameterized paths use :name, for example /people/:id. Route parameters are decoded and passed through context.params.

Security

• Put local secrets in .dev.vars and never commit that file.
• Store production secrets with Cloudflare's secret management.
• Validate untrusted input in the controller before calling a model.
• Escape untrusted text in HTML views; the starter demonstrates this explicitly.
• Keep dependencies current and review npm audit output before deployment.

Scope of 0.1.x

This release intentionally contains a compact routing/composition core and one Cloudflare starter. Authentication, databases, AI providers, Polario MCP integration, and alternate hosting adapters belong in later optional additions rather than the core.

MIT © RCMV contributors