Setting Up GitHub with Fluid Designer


    Fluid Designer is constantly being updated and new features are being added all of the time. Every 6 months (or so) we make an official release and that version is shipped with the Microvellum ERP application, but you might not want to wait that long to get the new features. This article will tell you how to keep up to date with the latest changes of Fluid Designer. All of the latest Fluid Designer code is located here.

    Navigating the GitHub Site

    At the first glance this site might look complicated, but there are only a few things that you need to know about this site.

    Along the top of the interface there are tabs that allow you to view information about this repository.


    Code - This tab displays the all of the files that make up the Fluid Designer application. Unless you getting involved in development the only button that you need to know about is the “Clone or download button”. This will allow you to download the Fluid Designer application we will go over how to do this in the Cloning/Downloading the Fluid Designer Repository.

    Issues - This tab displays all of the known issues or improvements that we would like to make to the Fluid Designer Application. If you have a suggestion or a question feel free to add an issue to this. Our Developers regularly check these issues.

    Projects - This tab displays all of the current projects that our development team is working on. This is really just a way for us to categorize and group the current issues.

    Wiki - This tab displays help information about how to use fluid designer. This is not a complete set of documentation. The majority of the documentation is kept of the support site.

    If you would like more information about how to use the GitHub Site Please view the GitHub Help Documentation.

    Cloning/Downloading the Fluid Designer Repository

    To clone the Fluid Designer repository first create a Free GitHub Account. Once you have created an account it is recommend that you download the github desktop app. This will make the process of downloading and keeping up to date with the repository very easy.

    The desktop app can be downloaded from here.

    Once you have created your account and have installed the desktop application. Go the Fluid Designer Repository, make sure you are on the code tab, and click the “Clone or download button” then select Open in Desktop. This should start the desktop app automatically.


    Once the application is open. Click the Plus button in the top right corner of the screen, click on the Microvellum Account, select Clone, select the Fluid Designer Repository, and click Clone Repository at the bottom of the interface. This will start downloading all of the Fluid Designer Files.



    Once the Repository has finished downloading you can find the files by browsing to the location where your GitHub repositories are stored. By default this is going to be located here.


    Now that you have the repository downloaded you can open up the application by launching the blender.exe. By default this will be located here:


    Connecting Fluid Designer to Microvellum ERP

    Now that you have everything downloaded you will want to change what version of Fluid Designer the Microvellum ERP application is pointed to. This can be done by opening up the Microvellum Options Page.


    Selecting the Fluid Designer Tab and browsing to the new blender.exe location. Again, by default this will be located here.


    Now that you have pathed to the new blender.exe Microvellum ERP will now use this version every time the application is launched.

    Staying up to Date

    Now that you have everything set up, all you need to know, is how to stay updated with the application. Launch the GitHub Desktop app, click on the Fluid Designer repository on the left side of the interface and click sync in the top right hand of the interface. This will update all of the Fluid Designer Code.



    Cloning Libraries

    Microvellum also keeps separate repositories for all of the advanced libraries, but these repositories are private. If you want access to the advanced library repositories you must be on an active Fluid Designer subscription, and you must request access by emailing with the subject title "Fluid Designer Repo Request". Please provide what repositories you want access to along with your GitHub UserName.

    • Library-Advanaced_Cabinets
    • Library-Advanced_Closets
    • Library-Advanced_Door_Builder

    Once your request has been reviewed you will receive an email with an invitation to have access to the repository.