FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

ColdBox Relax

Build Status


RELAX = RESTFul Tools For Lazy Experts!

What is Relax? ColdBox Relax is a set of RESTFul tools for lazy experts. We pride ourselves in helping you (the developer) work smarter and ColdBox Relax is a tool to help you document your projects faster. ColdBox Relax provides you with the necessary tools to automagically model, document and test your RESTFul services. One can think of ColdBox Relax as a way to describe RESTFul web services, test RESTFul web services, monitor RESTFul web services and document RESTFul web services–all while you relax!


Apache License, Version 2.0.


  • Code:
  • Issues:
  • Documentation:


  • Lucee 45+
  • ColdFusion 11+


Just drop into your modules folder or use the box-cli to install

box install relax


You will need to update the your ColdBox.cfc with a relax structure with your preferred settings for Relax.

relax = {
    // The location of the relaxed APIs, defaults to models.resources
    APILocation = "modules.relax.models.resources",
    // Default API to load, name of the directory inside of resources
    defaultAPI = "myapi",
    // History stack size, the number of history items to track in the RelaxURL
    maxHistory = 10


You can look at the samples inside of this module under the models/resources directory. To start you can copy the Relax.cfc into your own project folder and then start spicing up the API via the RelaxDSL methods.

Copyright Since 2005 ColdBox Framework by Luis Majano and Ortus Solutions, Corp | |


Because of His grace, this project exists. If you don't like this, then don't read it, its 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. And not only so, but we glory in tribulations also: knowing that tribulation worketh patience; And patience, experience; and experience, hope: And hope maketh not ashamed; because the love of God is shed abroad in our hearts by the Holy Ghost which is given unto us. ." Romans 5:5


"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)" Jn 14:1-12



  • Updated all JS libraries
  • Updated npm libraries
  • Updated grunt to leverage new locations of module template
  • CommandBox Readiness for static assets
  • Fix console logs left behind
  • Dropped lucee 4 support
  • Added acf2018 support
  • module layout updates
  • Fixes on module root when embedeed in app


  • Bumps cbjavaloader dependency version to ^2


  • Fixes cbswagger dependency tracking


  • Adds integration with cbswagger module to introspect application RESTful route metadata


  • Fixes a bug where POST methods were passing a conditional key used in preHandler
  • Fixes a bug where Relaxer auth password was being transmitted as username
  • Fixes an issue where Relaxer history became unusable because of bad response
  • Fixes an issue where form parameters where not being interpreted correctly by the Relaxer Service


  • Standardizes OpenAPI specification
  • Relax DSL marked as deprecated ( EOL @ 4.0.0 )
  • ACF Compatibility updates
  • PDF/HTML Export strategy updates
  • UI Bug fixes and enhancements
  • Relaxer Test Tool UI and history replay improvements
  • ACF Compatibility updates
  • Performance enhancements for OpenAPI doc parsing
  • Improvements to $ref parsing and recursion
  • Relaxer service not sending form data correctly
  • Refactoring of Relaxer to support typed API on calls to HTTP
  • Relaxer not sending http proxy ports
  • Relaxer not sending right name for params
  • PDF Export Capabilities


  • Migrates core OpenAPI parsing to swagger-sdk module
  • Implements one-click route population and testing in API test tool
  • Misc bug fixes and additional support for recursion


  • [RELAX-25] - SSL support for assets
  • Converts development workflow to user Grunt/SASS/RJS Optimizer
  • [RELAX-5] - Implements OpenAPI Specification as Relax default
  • Implements backward compatiblity for RelaxDSL
  • [RELAX-3] - Relaxer is now async
  • [RELAX-11] - Relaxer functionality is now rendered in-page
  • [RELAX-7] - Udates DSL Documentation to use dynamic JS Templating
  • Documentation loading is now async
  • Adds OpenAPI specification documentation
  • Exports for Trac and WikiMedia are now async
  • Import issues resolved and converted to async
  • Converts code highlighter from SyntaxHighlighter to Prism.js


  • [RELAX-22] - Updated build scripts for using DocBox
  • [RELAX-23] - Travis CI integration for tests
  • [RELAX-24] - Update of all dependencies of the shell tester
  • [RELAX-21] - Update StringBuffer to StringBuilders
  • [RELAX-4] - Remove dependency on sessions
  • [RELAX-12] - Sample API is excluded
  • [RELAX-20] - The Resource URL changes for every code change, updated internal hash to pattern hash
  • [RELAX-1] - Implement display and DSLDoc modeling modifications to the Relax module
  • [RELAX-17] - Make test shell full URL rewritable
  • [RELAX-18] - Ability to view resource details from doc viewer


  • Updates on box.json and locations
  • Updated readme
  • Updated full skin assets
  • Included sample resources in build
  • Navigation fixes
  • Module Standalone route generation


  • Fixed resource headers, as they are not showing



Here are all the versions for this package. Please note that you can leverage CommandBox package versioning to install any package you like. Please refer to our managing package version guide for more information.

Version Created Last Update Published By Stable Download
3.2.0-snapshot Mar 07 2019 05:19 PM Mar 07 2019 05:19 PM Ortus Solutions (ortus)
3.1.0+141 Mar 07 2019 05:20 PM Mar 07 2019 05:20 PM Ortus Solutions (ortus)
3.1.0+131 Aug 14 2018 04:34 PM Aug 14 2018 04:34 PM Ortus Solutions (ortus)
3.1.0-snapshot Jan 25 2018 02:10 PM Mar 06 2019 06:11 PM Ortus Solutions (ortus)
3.0.3+126 Jan 25 2018 01:59 PM Jan 25 2018 01:59 PM Ortus Solutions (ortus)
3.0.3-snapshot Jan 25 2018 01:27 PM Jan 25 2018 01:27 PM Ortus Solutions (ortus)
3.0.2+123 Nov 17 2017 05:00 PM Nov 17 2017 05:00 PM Ortus Solutions (ortus)
3.0.2-snapshot Nov 17 2017 04:48 PM Nov 17 2017 04:48 PM Ortus Solutions (ortus)
3.0.1+121 Aug 28 2017 12:51 PM Aug 28 2017 12:51 PM Ortus Solutions (ortus)
3.0.1-snapshot Apr 17 2017 05:35 PM Apr 17 2017 05:35 PM Ortus Solutions (ortus)
3.0.0+118 Apr 11 2017 11:48 AM Apr 11 2017 11:48 AM Ortus Solutions (ortus)
3.0.0-snapshot Mar 13 2017 12:18 PM Mar 13 2017 12:18 PM Ortus Solutions (ortus)
2.3.2-snapshot Feb 20 2017 09:18 PM Mar 02 2017 03:53 PM Ortus Solutions (ortus)
2.3.1-snapshot Feb 19 2017 05:34 PM Feb 27 2017 08:00 AM Ortus Solutions (ortus)
2.2.0 Feb 03 2011 04:59 PM Jun 10 2016 10:22 AM Ortus Solutions (ortus)


No collaborators yet.
4.91 / 11
  • Feb 03 2011 04:59 PM
  • Mar 07 2019 05:20 PM
  • 10538
  • 5333
  • 8585