Motmir is a Full E-Commerce Web App with an API Powered by Python(v3.8.10) and flask(v2.0.2), and Reactjs(v17.0.2) for Front-End, and Mysql(v8.0.27) for the database.
I'm from a town where dattes fruits are the main products produced by every farmer here, and my father is one of them. So i got this idea of this online shop to help extend the market for these specific fruits, especially our unique ones that don't exist anywhere else in the world.
pip3 install -r requirements.txt
cd motmirfrontend
npm install
cd ..
sudo apt install mysql-client mysql-community-server mysql-server
# Note : Most commented variables will be added directly to the app host server envirenment variables
FLASK_ENV=production # change this to `development` if needed
FLASK_APP=app # default
# production db
# MYSQL_USER= db user name
# MYSQL_PWD= db password
# MYSQL_HOST= db host domain or ip
# MYSQL_DB= db name
# test db
MYSQL_USER=motmir_dev # default
MYSQL_PWD=motmir_pwd # default
MYSQL_HOST=localhost # default
MYSQL_DB=motmir_db # default
TYPE_STORAGE=db # default
MYSQL_ENV=prod # change this to `test` if you want the databases tables to be dropped on every api app restart
API_HOST=0.0.0.0 # default
API_PORT=5000 # default
# if you didn't specify these variables the app will fail on sending emails to clients which may or may not result in other problems
# GMAIL_SENDER_EMAIL= the senders email (required)
# GMAIL_CREDENTIALS= Your gmail api credentials json object (required)
# GMAIL_TOKEN= Your gmail api token json object which will be created automatically on first login so this can be empty until you have the token
FRONTEND_BASE_URL=localhost:3000/
export const baseUrl = 'localhost:5000'; API's URL with out the / slash at the end
export const imagesUrl = 'https://ik.imagekit.io/motmir/'; Your imagekit.io URL-endpoint to fetch images from as im using imagekit's service to store my products images and create a folder called product-images in the root
# You can update the file setup_mysql_dev.sql
# with the names and previliges you want
# but you will need to update the envirenement
# variables. check Configuration section for that.
sudo service mysql start
sudo mysql -p < setup_mysql_dev.sql
python3 -m api.create_admin_profile
# You can access admin panel in localhost:3000/admin after you start the app
python3 -m api.app
cd motmirfrontend
npm run start
In api/.env Update your Database and API host informations
MYSQL_USER=Database username
MYSQL_PWD=Database user's password
MYSQL_HOST=Database Host url or ip
MYSQL_DB=Database Name
MYSQL_ENV=prod
TYPE_STORAGE=db
API_HOST=0.0.0.0
API_PORT=5000
# if you didn't specify these variables the app will fail on sending emails to clients which may or may not result in other problems
# GMAIL_SENDER_EMAIL= the senders email (required)
# GMAIL_CREDENTIALS= Your gmail api credentials json object (required)
# GMAIL_TOKEN= Your gmail api token json object which will be created automatically on first login so this can be empty until you have the token
FRONTEND_BASE_URL=localhost:3000/
And if you are testing you can change the variable MYSQL_ENV value to test which will drop all the tables in the database on every app Start/Restart
MYSQL_ENV=test
And if you created your own Storage class for another type of storage like File Storage you can use the variable TYPE_STORAGE To initialize the right Storage Instance that you wanted which can be done in this file
models/__init__.py
in motmirfrontend/src/index.js Update the variables baseUrl and imagesUrl
baseUrl = API's URL
imagesUrl = Your imagekit.io URL-endpoint to fetch images from as im using imagekit's service to store my products images
example:
export const baseUrl = 'https://motmir-api.onrender.com'; //'http://localhost:5000'
export const imagesUrl = 'https://ik.imagekit.io/motmir/'; // exact folder not specified in case you have different folders by default images are stored in a folder called `products-images`
If you would like to contribute to the project, you may create a Pull Request containing your proposed changes and we will review it as soon as we are able! Please review our contributing guidelines first.
Before interacting with our community, please read our Code of Conduct.
Motmir is free and open-source software licensed under the GNU General Public License v3.0. Everything created by Elmahdi1962.
Elmahdi1962 [email protected]