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

Inherited a CFML Application With Few Tests? Here’s Where to Start!

Inherited a CFML Application With Few Tests? Here’s Where to Start!

You need to change an application that has been running for years.

It might be a ColdFusion customer portal, a Lucee application supporting internal operations, or a CFML system your team is preparing to modernize. People depend on it, but some of its behavior lives in old tickets, scattered documentation, and the memory of whoever has supported it longest.

Now a release is approaching. You know more testing would help. The difficult part is deciding where to begin without putting every other priority on hold.

Start with one important workflow and build evidence around what it needs to do.

Explore Ortus Quality Assurance Services

Maria Jose Herrera
Maria Jose Herrera
October 27, 2026
Your ColdFusion Upgrade Passed. Did Your Business Workflows?

Your ColdFusion Upgrade Passed. Did Your Business Workflows?

The server restarted. The administrator shows the expected version. Your homepage loads, and a few familiar screens look fine.

Would you tell the business the upgrade is complete?

Consider an illustrative scenario: a customer submits an order after an upgrade. The application saves it and displays a confirmation page. But the confirmation email never arrives, and the scheduled process that sends the order to fulfillment has not completed.

From the browser, the transaction...

Maria Jose Herrera
Maria Jose Herrera
October 22, 2026