ViUR base: Start here with your new ViUR project!
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
vi @ 2799a51

ViUR base

base provides a basic project structure to start a new ViUR project.


This repository works both as a base structure for new projects created with ViUR, and serves a possibility to generate the quick start script, which helps to rapidly setup an empty, new ViUR project without any compromises.

How to use this repository

It is recommended to clone the base repository including its submodules into a new directory of your choice.

git clone your-project
cd your-project

Then, to make sure that the placeholders in app.yaml and are properly replaced and that you won't accidentally overwrite the viur-base repo, use the included script.

You need to enter an author name and an app ID to identify your app for later deployment and to be able to run the locally.

The script will also initialize and update the submodules and disconnect the repo from the viur-base repository origin.


Switch sub-modules to SSH

Especially in ViUR development projects or for projects at Mausbrand that are heavily involved in changes to server and vi, it is necessary to change the HTTPS submodules to SSH. This can easily be done for all submodules and their submodules with these few commands:

# change server
pushd deploy/server
git remote set-url origin

# change vi
pushd vi
git remote set-url origin
cd html5
git remote set-url origin
cd ../public/icons
git remote set-url origin

# change ignite
pushd ignite
git remote set-url origin

Generating a

To generate a new, just call the script like this:

python >

The can than be distributed to easily setup new projects from the contents of the deploy/ folder. It automatically downloads the latest ViUR server and pre-compiled vi from the ViUR website to immediately provide a running project.


We take a great interest in your opinion about ViUR. We appreciate your feedback and are looking forward to hear about your ideas. Share your visions or questions with us and participate in ongoing discussions.


ViUR is developed and maintained by Mausbrand Informationssysteme GmbH, from Dortmund in Germany. We are a software company consisting of young, enthusiastic software developers, designers and social media experts, working on exciting projects for different kinds of customers. All of our newer projects are implemented with ViUR, from tiny web-pages to huge company intranets with hundreds of users.

Help of any kind to extend and improve or enhance this project in any kind or way is always appreciated.


Copyright (C) 2012-2018 by Mausbrand Informationssysteme GmbH.

Mausbrand and ViUR are registered trademarks of Mausbrand Informationssysteme GmbH.

You may use, modify and distribute this software under the terms and conditions of the GNU Lesser General Public License (LGPL). See the file LICENSE provided within this package for more information.