Marko Run is an application framework that provides a zero-configuration way to build full-stack web applications using the Marko templating language.
The framework solves the problem of reducing setup complexity for Marko applications by providing sensible defaults and convention-based routing. It uses a file-based routing system where files prefixed with `+` in a routes directory automatically become pages, layouts, or request handlers. Pages use Marko components for server-side rendering with automatic streaming and partial hydration. Layouts wrap nested pages and receive request context as input. Handlers are TypeScript or JavaScript files that export HTTP verb functions for API routes. The tool ships with a default Vite configuration and Node-based adapter, eliminating the need for manual build setup.
Marko Run suits developers building full-stack applications who want minimal configuration overhead and prefer convention over configuration. The framework scales from simple single-page projects to production applications with multiple deployment targets. It is particularly well-suited for projects where server-side rendering, streaming responses, and automatic code splitting are valuable. The tool is currently in beta, which means it is still stabilizing and developers should be prepared for potential breaking changes or missing features.
The project maintains active development with regular updates to its core functionality. The codebase is written in TypeScript, providing type safety and editor support throughout the framework. Development activity shows ongoing refinement of the routing system, handler validation, and deployment adapters. The team continues to expand platform support beyond the default Node adapter, working toward the stated goal of running anywhere through web standards alignment.
