# Quick Start
### Compile the product
To compile the product and use it locally, **Python3** should be installed and accessible via the terminal. The source code can be downloaded from the official repository or downloaded in ZIP format from the [product page](https://codedthemes.com/item/datta-able-pro-flask-template/).
**Download the sources** and unzip the archive.
```
$ cd flask-datta-able-pro
```
**Create a virtual environment.**
```
$ virtualenv env
$ source env/bin/activate
```
**Install modules.**
```
$ pip3 install -r requirements.txt
```
**Set up the environment.**
```
$ export FLASK_APP=run.py
$ export FLASK_ENV=development
```
**Start the application.**
```
$ flask run
```
If all goes well, we can access [**Flask Datta Able PRO**](https://codedthemes.com/item/datta-able-pro-flask-template/) in the 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.
### Codebase structure
The project is coded using a simple and intuitive structure presented below:
```
< PROJECT ROOT >
|
|-- app/ # Implements app logic
| |-- base/ # Base Blueprint - handles the authentication
| |-- home/ # Home Blueprint - serve UI Kit pages
| |
| __init__.py # Initialize the app
|
|-- requirements.txt # Development modules - SQLite storage
|-- requirements-mysql.txt # Production modules - Mysql DMBS
|-- requirements-pqsql.txt # Production modules - PostgreSql DMBS
|
|-- .env # Inject Configuration via Environment
|-- config.py # Set up the app
|-- run.py # Start the app - WSGI gateway
|
|-- ************************************************************************
```
###
### The bootstrap flow
* `run.py` loads the `.env` file
* Initialize the app using the specified profile: *Debug* or *Production*
* If env.DEBUG is set to *True* the SQLite storage is used
* If env.DEBUG is set to *False* the specified DB driver is used (MySql, PostgreSQL)
* Call the app factory method `create_app` defined in app/**init**.py
* Redirect the guest users to the **Login** page
* Unlock the pages served by ***home*** blueprint for authenticated users
### Deployment
The app is provided with a basic configuration to be executed in [Docker](https://www.docker.com/), a popular virtualization software. To start the project inside a Docker container, please type the following commands:
**UNZIP the archive** and change the current directory
```
$ cd flask-datta-able-pro
```
**Download the required packages**
```
$ sudo docker-compose pull
```
**Build the Docker packages**
```
$ sudo docker-compose build
```
**Start the dockerized application**
```
$ sudo docker-compose up
```
By visiting`http://localhost:5005`the browser we should see the app running.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://codedthemes.gitbook.io/flask-datta-pro/quick-start.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.