Skip to content

app-generator/flask-windows-95-ui-kit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open-Source web app coded in Flask on top of Windows 95 UI Kit (free version) - Starter generated by AppSeed Web App Generator.

Features

  • UI-Ready, Jinja2 templating
  • SQLite database, Flask-SQLAlchemy ORM
  • Session-Based auth flow (login, register)
  • UI Kit: Windows 95 UI Kit by Themesberg
  • MIT License
  • Free support via Github issues tracker
  • Paid 24/7 Live Support via Discord.

Links


Windows 95 UI Kit - Open-Source Web App Coded in Flask.


Prepare your environment

The product is built on top of Flask, a popular Python Web Framework. To build the app, we need a basic tool-chain installed in the workstation:

  • Python3 - the programming language used to code the app
  • Git - used to clone the source code from the Github repository
  • Basic development tools (g++ compiler, python development libraries ..etc) used by Python to compile the app dependencies in your environment.

Check Python (using the terminal)

$ # Check Python version
$ python --version
Python 3.7.2 # <--- All good

Check GIT command tool (using the terminal)

$ # Check git
$ git --version
$ git version 2.10.1.windows.1 # <--- All good

For more information on how to set up your environment please access the below links. In case we've missed something, contact us on Discord.


Build from sources

$ # Clone the sources
$ git clone https://github.com/app-generator/flask-windows-95-ui-kit.git
$ cd flask-windows-95-ui-kit
$
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .\env\Scripts\activate
$ 
$ # Install requirements
$ pip3 install -r requirements.txt
$
$ # Set the FLASK_APP environment variable
$ (Unix/Mac) export FLASK_APP=run.py
$ (Windows) set FLASK_APP=run.py
$ (Powershell) $env:FLASK_APP = ".\run.py"
$
$ # Set up the DEBUG environment
$ # (Unix/Mac) export FLASK_ENV=development
$ # (Windows) set FLASK_ENV=development
$ # (Powershell) $env:FLASK_ENV = "development"
$
$ # Run the application
$ # --host=0.0.0.0 - expose the app on all network interfaces (default 127.0.0.1)
$ # --port=5000    - specify the app port (default 5000)  
$ flask run --host=0.0.0.0 --port=5000
$
$ # Access the app in browser: http://127.0.0.1:5000/

Note: To use the app, please access the registration page and create a new user. After authentication, the app will unlock the private pages.


Code-base structure

The project has a super simple structure, represented as bellow:

< PROJECT ROOT >
    |
    |--- app/__init__.py
    |--- app/
    |     | --- <static/assets>
    |     |       |
    |     |       |--- <css>
    |     |       |--- <Js>
    |     |       |--- <img>
    |     |
    |     | --- <templates>
    |     |       |
    |     |       |---<includes>                   # Page chunks, components
    |     |       |     |
    |     |       |     | --- navigation.html      # Top bar
    |     |       |     | --- sidebar.html         # Left sidebar
    |     |       |     | --- scripts.html         # JS scripts common to all pages
    |     |       |     | --- footer.html          # The common footer
    |     |       |
    |     |       |---<layouts>                    # App Layouts (the master pages)
    |     |       |     |
    |     |       |     | --- base.html            # Used by common pages like index, UI
    |     |       |
    |     |       |---<pages>                      # Auth Pages (login, register)
    |     |       |     |
    |     |       |     | --- index.html           # Default page
    |     |       |     | --- docs.html            # Presents the components
    |     |       |     | --- login.html           # Login page 
    |     |       |     | --- register.html        # User registration page  
    |     |       |
    |
    |--- requirements.txt
    |
    |--- run.py
    |
    |-----------------------------

Credits & Links



Flask Win95 UI Kit - Provided by AppSeed Web App Generator.

Packages

 
 
 

Languages

  • HTML 63.3%
  • CSS 34.1%
  • Python 1.8%
  • JavaScript 0.8%