Home

Awesome

What is it?

This is an example App template for the outstanding REMI GUI framework created by Davide Rosa.

REMI Website

REMI Github Repository

REMI Documentation

REMI Reddit Support Group

REMI Gitter Chat Room

See it in action

REMI-App-Template running on 1 Core 512 MB RAM Ubuntu VServer

Why making an App Template?

While REMI itself is great and the usage is very straight forward many users may find it a little hard to get into it. Users are asking very often how to make a WebUI with different Views. That's where this repo comes in.

Furthermore in the Gitter Chat there are frequent questions about problem solutions and from time to time the solution can easily be put into this repo in order to not forget about the solution.

Getting started

Just clone the repo with

git clone https://github.com/cheak1974/remi-app-template.git

If you want a completely empty App template without the example Views and example Models etc. we hold a special branch which is called "empty" for you. Just clone the repo with the following command:

git clone -b empty https://github.com/cheak1974/remi-app-template.git

Change to the project folder

cd app-template-for-remi

Install a virtual Environment inside the project folder

python -m venv .\venv

If you don't have installed VirtualEnvironment on your Workstation you can do:

pip install virtualenv

Change to the Script folder of the virtual Environment

cd venv

cd Scripts

Activate the virtual Environment with activate (Linux) or activate.bat (Windows).
Go back to the project's root folder with:

cd .. cd ..

Then install the needed libraries with

pip install -r requirements.txt

Start up the App with python AppTemplate.py file in the project's root. The App should startup and open a local browser window with the Apps start page.

Structure of the App Template

SubfolderContent
configContains config.py which will be imported. Your project configuration lives here. config/config.py overwrites the default values in core/globals.py
coreContains the main program webapp.py and the webapi.py alongside with the global Dictionaries in globals.py for project wide data access.
dialogsYou can create your own dialogs. These files go here.
helpersCode that fits nowhere else can be placed in helpers folder.
modelsIf your views need data structures they can be placed here to follow the MVC paradigm.
sslkeysIf you want Remi to work with SSL/TLS place your certificate and key files here.
staticStatic content like JS, CSS and binaries like Images, Videos etc.
viewsThe views of your application.
widgetsYou can create custom Widgets too. These files should be placed here.

App Startup Process

It is important to understand, what happens when the App starts.

Using REMIs graphical UI Editor to create Views easily

...