Blog

Coldbox Legacy App Demo

Brad Wood January 18, 2016

Spread the word

Brad Wood

January 18, 2016

Spread the word


Share your thoughts

There are a lot of people out there in the CFML world managing legacy codebases.  Some of them use frameworks that are no longer maintained, and many  use no framework at all.  A common question that I get is whether an app can be slowly converted over to  ColdBox without having to rewrite everything at once.  The answer is YES!  ColdBox will comfortably live alongside your legacy code, giving you the chance to slowly convert it over as you get the chance.  

Since this has come up at conferences and in the CFML Slack team so often I created a demo app that shows legacy pages living alongside MVC as well as some tricks to even keep you old files in the URL even though the requests are being routed through a modern MVC framework.  This can be important for companies dealing with a lot of bookmarked pages out there.

The code is on GitHub here:

https://github.com/bdw429s/coldbox-legacy-app-demo

 To get this working sample app  up and running literally in seconds, even on a computer with no server installed, just grab CommandBox and run the following commands from the interactive shell:

mkdir coldbox-legacy-app-demo --cd
install bdw429s/coldbox-legacy-app-demo
server start

In a few seconds a browser window will open and you can click around through the menu items, reading the descriptions on each page that details how it works.  Then peruse through the small codebase to see how everything is set up.

There's many ways to set up ColdBox MVC inside your legacy application, and hopefully this sample app will give you some ideas and understanding to get underway.

 

Add Your Comment

Recent Entries

BoxLang 1.15.0 Released: Blazing Fast Strings, Runtime Portability, and much more

BoxLang 1.15.0 Released: Blazing Fast Strings, Runtime Portability, and much more

BoxLang 1.15.0 is a high-impact release with two big headlines and a long tail of hardening. The first headline is a massive performance upgrade to string handling: a new first-class BoxStringBuilder type, compile-time literal folding, smarter &= semantics, and a runtime concat strategy that automatically switches to builder-backed accumulation once your expression gets big enough. Your existing string-heavy code just got faster. No rewrites required.

Luis Majano
Luis Majano
July 09, 2026
MatchBox Web Server: BoxLang Without the Full Server Stack

MatchBox Web Server: BoxLang Without the Full Server Stack

MatchBox includes a native web runtime for building small, fast BoxLang web applications without requiring a JVM or a traditional servlet container. You can follow the MatchBox open beta at https://github.com/ortus-boxlang/matchbox. There are two related pieces in the beta today: a webroot server for .bxm templates and static assets, and a routed app server built around web.server(). Both are early, but they show the direction clearly: BoxLang should be able to serve HTTP from a compact native runtime when the application does not need the full JVM stack.

Victor Campos
Victor Campos
July 07, 2026