Since we moved to Git Arnis Lapsa already wrote a SQLite event store and Chris Chilvers fixed a bug. We encourage users fork Ncqrs code, make changes, commit them to your forked repository, and submit pull requests.

• Ncqrs at GitHub
• Ncqrs at Google Groups

If you are new to Git, I recommend watching the video of the Google TechTalk about Git from Randal Schwartz. Also Jason Meridth posted a great series called Git For Windows Developers.

Here is a list of tools we recommend to Windows developers:

• msysgit – Git on Windows
• GitExtension – great UI for Git and integrates with Visual Studio

The reference documentation will grow in the future and like the code we guess that is will never be done.

Go check it out: http://ncqrs.org/reference

The Ncqrs Framework uses Code Contracts to make sure things go as they have been planned to be. For precondition that are related to parameters, we use the Contract.Requires<TException> method. This method adds runtime validation of the preconditions and throws an exception when they where not satisfied. But to do this, the code has to be rewritten on compile time. That means, emitting the assertion check in the method. By default, runtime code contract checking it turned of for project. Unfortunately it looks like that this setting is not saved into the .csproj project file. So, to solve the problem you need to enable runtime code contract checking for every project in the Ncqrs Framework.

You need to enable runtime code contract checking for every project in the Framework folder of the Ncqrs solution. You can do this by following these steps:

1. Open the Ncqrs.sln file.
2. Now, for all project in the Framework folder:
   1. Open the project properties by right clicking on the project item in the solution explorer and then click on the Properties menu item.
   2. Click on the Code Contract property tab.
   3. Check the Perform Runtime Code Contract Checking checkbox.
   4. Also make sure the combobox after this checkbox is set to FULL.

In the end the code contracts project pane should look like this for every project in the Framework solution folder:

We would like to thank @arnodenuijl and @Survivor_Zero for reporting this problem.

The main goals of the Ncqrs Framework is helping you to build scalable applications according to the CQRS architecture concepts by offering a strong and robust framework that offers main components, infrastructure and takes away plumbing code by support for annotation and convention.

At the moment we offer only one release and that is a code only release. This is because Ncqrs should now only be used by people that got the balls to compile it them self and use it without proper documentation. The framework itself offers the most important infrastructure to build CQRS based applications, but lags good documentation. But that is where this blog, twitter and direct email contact come around.

• Rich components to support a full CQRS architecture.
• Easy Command mapping.
• Domain event mapping.
• Event sourcing support.
• Event storage with MSSQL or MongoDB support.
• Sample application that show a simple CQRS based application.
• Easy to extend!

The project is hosted at Codeplex. Releases can be found here and you can visit this page to see the changesets in the source control repository. The Mercurial source repository can be found here:

Clone URL: https://hg01.codeplex.com/ncqrs

For more information about the CQRS principles we refer to the following resources:

• Clarified CQRS by Udi Dahan
• Unshackle Your Domain by Greg Young
• Podcast with Greg Young

There is a little sample application that you can explore to see how the Ncqrs Framework works. Read the quick readme here: Running the sample application

To run the sample application you need Visual Studio 2010 and Code Contracts. If you have that installed, it will not take you more than 5 minutes to get the sample application running; otherwise, I’ll buy you a beer!

1. First download the latest release here and unpack.
2. Open the solution Ncqrs.sln that is located in the /src/ directory.
3. After the solution opened you should compile the solution.
4. Make sure everything compiled correctly and that there where no build errors.

1. Download MongoDB 1.4.0 for windows here.
2. Unpack all the content in the bin folder to c:\mongodb\.
3. Create the following folder c:\data\db
4. Start a Command Shell (cmd.exe) and cd to c:\mongodb\.
5. Now enter mongod.exe and hit enter.

1. Set Sample.UI as startup project.
2. Now you can just run the Sample.UI by hitting F5 in Visual Studio.