Well I figured I should write something in the readme ... so here we go.

Basically, this is a very simple coldfusion framework that follows in the steps all the other model-view-controller 
(mvc) frameworks out there. It's not the magic solution nor does it provide everything in a can ... so if that what your 
looking for this ain't for you.

Ok, so first off the framework requires coldspring (http://www.coldspringframework.org) ... and thats basically it.

The way to do thing when developing with blu ... is to put everything into a module! The shell does nothing more than 
load global shell variables and initialize all the modules on application start. Each module can be developed in its own 
little bubble and know nothing about any other modules also being used.

Now, as for how everything is wired ... each module requires the following:
/modulename
   /config
      - application.xml
      - coldspring.xml
      - urls.xml
   - controller.cfc

those are be basics ... but if you plan to display something (the view) to the user it is suggested you also have the 
following:
/modulename
   ... (see above)
   /view
      - dspPage.cfm
      - layoutPage.cfm

if you plan on pulling info from a database or something (for the model) ... I general use:
/modulename
     
   /model
      - *Facade.cfc
      /*SomeModelDirectories  
        - *SomeModelFiles.cfc

Well thats my typical application module structure ... all modules need to be placed in the /modules directory to be 
include on initialization.

To view an example module ... just look inside the modules directory ... you should see /yesimblu

That all for now (I'm going to sleep)... I'll add what the files do later.