Skip to content

About

The Official ColdBox MVC Platform Documentation

Topics

Resources

Stars

16 stars

Watchers

7 watching

Forks

Repository files navigation

description ColdBox is a conventions-based HMVC web development framework for the BoxLang JVM Language and ColdFusion (CFML).
icon computer-classic

Introduction

ColdBox HMVC v8.x

HMVC Framework

Standalone Libraries

ColdBox Hierarchical MVC is the de-facto enterprise-level HMVC framework for the BoxLang JVM language and the ColdFusion (CFML) language. It's professionally backed, conventions-based, modular, highly extensible, and productive. Getting started with ColdBox is quick and painless. ColdBox takes the pain out of development by giving you a standardized methodology for modern web development with features such as:

It provides a set of reusable code and tools that can be used to increase your development productivity, as well as a development standard for working in team environments.

Explore the Platform

🧭 Conventions over Configuration Predictable folder structure and naming so you spend time on features, not scaffolding conventions.md
🚏 Modern Routing DSL A fluent router for resources, groups, middleware, route-level caching, and more README.md
🤖 AI-Native Routing First-class toAi(), toMCP(), and toAiGateway() terminators for building agentic APIs ai-routing.md
📡 Real-Time Streaming Server-Sent Events as a first-class citizen, with a fluent emitter API server-sent-events.md
🧩 HMVC Modules Build self-contained, reusable application modules with their own routes, models, and views README.md
🔌 RESTful APIs Content negotiation, structured responses, and a dedicated REST handler base class rest-handler.md
🎯 Event-Driven Interceptors Hook into the framework lifecycle or announce your own custom events README.md
⚡ Async & Parallel Programming Futures, schedulers, and parallel collection operations out of the box README.md
🧪 Integration & Unit Testing TestBox-powered testing baked into every generated application README.md

AI Capabilities

ColdBox is built for the agentic era. Beyond toAi()/toMCP()/toAiGateway() routing above, the platform ships:

🤖 Agentic ColdBox A full AI development toolkit built into the coldbox-cli: guidelines, a 200+ skill registry, multi-agent support (Claude, Copilot, Cursor, Codex, Gemini, and more), and 30+ built-in MCP documentation servers agentic-coldbox.md
🔌 cbMCP Live application introspection over MCP, so an AI agent can query your running app in real time (🚀 BoxLang only) coldbox-mcp-server.md
💬 Conversational Context Automatic userId/conversationId/threadId threading on toAi() routes for multi-turn agents ai-routing.md
🚪 AI Gateway Routing Mount a BoxLang AI Gateway (Slack, Telegram, WhatsApp, or a signed webhook) directly on a route ai-gateway-routing.md

Look for the 🚀 BoxLang Exclusive badge throughout these docs to spot features only available on the BoxLang runtime.

What is BoxLang?

BoxLang is a modern dynamic JVM language developed by the ColdBox team that can be deployed on multiple runtimes: operating system (Windows/Mac/*nix/Embedded), web server, lambda, iOS, android, web assembly, and more. BoxLang combines many features from different programming languages, including Java, CFML, Python, Ruby, Go, and PHP, to provide developers with a modern, functional and expressive syntax.

ColdBox has been designed to work in both BoxLang and CFML language engines. However, it is extremely optimized for BoxLang, since it is the same team that develops the language and the framework.

Read more about BoxLang here: https://boxlang.io

License

The ColdBox Platform is open source and licensed under the Apache 2 License.

  • Copyright by Ortus Solutions, Corp
  • ColdBox, CacheBox, WireBox, and LogBox are registered trademarks of Ortus Solutions, Corp.

Discussion & Help

The Ortus Community is how to get help for our entire platform and modules: https://community.ortussolutions.com.

{% embed url="https://community.ortussolutions.com" %} community.ortussolutions.com {% endembed %}

You can also join our Slack Box Team at: https://boxteam.ortussolutions.com

{% embed url="https://boxteam.ortussolutions.com" %} boxteam.ortussolutions.com {% endembed %}

Reporting a Bug

We all make mistakes from time to time :) So why not let us know about it and help us out? We also love 😍 pull requests, so please star us and fork us at: https://github.com/coldbox/coldbox-platform

Jira Issue Tracking

All platform issues — ColdBox Core, CacheBox, LogBox, and WireBox — are tracked in the single ColdBox Jira project:

Professional Open Source

ColdBox is a professional open source software backed by Ortus Solutions, Corp offering services like:

  • Custom Development
  • Professional Support & Mentoring
  • Training
  • Server Tuning
  • Security Hardening
  • Code Reviews
  • Much More

Resources

HONOR GOES TO GOD ABOVE ALL

Because of His grace, this project exists. If you don't like this, don't read it, it's not for you.

"Therefore being justified by faith, we have peace with God through our Lord Jesus Christ: By whom also we have access by faith into this grace wherein we stand, and rejoice in hope of the glory of God." Romans 5:5

About

The Official ColdBox MVC Platform Documentation

Topics

Resources

Stars

16 stars

Watchers

7 watching

Forks

Releases

Packages

Used by

Contributors