Flask & Stripe `Mini eCommerce`

Open-source mini eCommerce project that loads the products from JSON files saved in the templates directory (no database required) and uses a decent UI for page styling - Powered by Flask.

👉 Flask & Stripe Presentation - published on YouTube
👉 Deploy Flask on Render - Step-by-step tutorial
👉 Free Support via Github (issues tracker) and Discord.

Roadmap & Features

Status	Item	info
✅	Flask	For `backend logic`
✅	Stripe	`Payment processor`
✅	Soft UI Design	(Free Version) by `Creative-Tim`
✅	JSON	`Products definition` - see sample
✅	Automatic Products Discovery	Source DIR: templates\products
❌	Deployment	`Docker` & Pages Compression
❌	Dw Products from Stripe	On going development via Python Stripe Library
❌	CI/CD	Render Deployment Platform

Flask-Stripe-Payments-Open-Source-Sample.mp4

✨ Start the app in `Docker`

👉 Step 1 - Download the code from the GH repository (using GIT)

$ git clone https://github.com/app-generator/sample-flask-stripe.git
$ cd sample-flask-stripe

👉 Step 2 - Add STRIPE secrets in Dockerfile

# Stripe Secrets 
ENV STRIPE_SECRET_KEY      <YOUR_STRIPE_SECRET_KEY>
ENV STRIPE_PUBLISHABLE_KEY <YOUR_STRIPE_PUBLISHABLE_KEY>

👉 Step 3 - Start the APP in Docker

$ docker-compose up --build

Visit http://localhost:5085 in your browser. The app should be up & running.

✨ Quick Start

👉 Rename env.sample to .env

Edit STRIPE_SECRET_KEY - provided by Stripe Platform
Edit STRIPE_PUBLISHABLE_KEY - provided by Stripe Platform

👉 Install dependencies

$ virtualenv env
$ source env/bin/activate
$ pip install -r requirements.txt

👉 Start the App

$ flask run

👉 Access the products and initiate a payment

IMPORTANT: Make sure your Stripe account is running in TEST Mode and Use Test CC provided by Stripe:

CC Number: 4242 4242 4242 4242
Any data for the rest of the fields

✨ Create a new Product

Go to app/templates/products directory
Create a new JSON file with data:
- name: Used in product page & Cards
- price: Used for payment
- currency: Used for payment
- info: used in cards
- short_description: used in product page
- full_description: used in product page
Create Media Files
- Go to master/app/static/products
- Create a directory using the same name as for JSON file
  - Create card.jpg: 500x335px
  - Create cover.jpg: 2100x1400px
Start or refresh the app
- The new product should be listed in the products/ page
- Product page is available at address:
  - http://localhost:5000/products/<SLUG>/ where the SLUG is the name of the JSON file

Sample product page generated for Air ZOOM Pegasus, assets loaded from here

✨ Codebase structure

The project has a simple structure, represented as bellow:

< PROJECT ROOT >
   |
   |-- app/__init__.py
   |-- app/
   |    |-- static/
   |    |    |-- <css, JS, images>         # CSS files, Javascripts files
   |    |
   |    |-- 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
   |    |    |    |-- base-fullscreen.html # Used by auth pages (login, register)
   |    |    |
   |    |    |-- products/                        # Define your products here
   |    |    |    |-- nike-goalkeeper-match.json  # Sample product
   |
   |-- requirements.txt
   |
   |-- run.py
   |
   |-- ************************************************************************

✨ Credits & Links

Flask Framework - The official website
Stripe Dev Tools - official docs

Flask Stripe Sample - Free sample provided by AppSeed.

akhilmeena/sample-flask-stripe-medium