https://github.com/app-generator/ecommerce-fastapi-stripe-clone
FastAPI & Stripe Mini eCommerce
https://github.com/app-generator/ecommerce-fastapi-stripe-clone
appseed fastapi fastapi-stripe stripe
Last synced: 4 months ago
JSON representation
FastAPI & Stripe Mini eCommerce
- Host: GitHub
- URL: https://github.com/app-generator/ecommerce-fastapi-stripe-clone
- Owner: app-generator
- License: mit
- Created: 2022-10-27T15:29:10.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-27T17:37:25.000Z (over 3 years ago)
- Last Synced: 2025-03-29T06:52:16.650Z (about 1 year ago)
- Topics: appseed, fastapi, fastapi-stripe, stripe
- Language: HTML
- Homepage: https://youtu.be/5kCE41duksk
- Size: 8.56 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# [FastAPI & Stripe](https://blog.appseed.us/fastapi-stripe-free-ecommerce/) `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 **[FastAPI & Stripe](https://blog.appseed.us/fastapi-stripe-free-ecommerce/)**.
> 👉 [FastAPI & Stripe eCommerce](https://youtu.be/5kCE41duksk) - `Video Presentation`
### Roadmap & Features
| Status | Item | info |
| --- | --- | --- |
| ✅ | **FastAPI** | For `backend logic` |
| ✅ | **Stripe** | `Payment processor` |
| ✅ | **[Soft UI Design](https://www.creative-tim.com/product/soft-ui-design-system?AFFILIATE=128200)** | (Free Version) by `Creative-Tim` |
| ✅ | **JSON** | `Products definition` - see [sample](./src/templates/products/air-zoom-pegasus.json) |
| ✅ | Automatic Products Discovery | Source DIR: [templates\products](./src/templates/products) |
| ❌ | **Deployment** | `Docker` & Pages Compression |
| ❌ | **CI/CD** | Render Deployment Platform |
## ✨ Manual Build
The process is basically the usual set up for any Python app: `environment` set up, `dependencies` install, and `bootstrap`.
> 👉 **Step 1** - `Download the code` from the GH repository (using `GIT`)
```bash
$ git clone https://github.com/app-generator/ecommerce-fastapi-stripe.git
$ cd ecommerce-fastapi-stripe
```
> 👉 **Step 2** - Rename `env.sample` to `.env` and provide the Stripe Secrets
- Edit `STRIPE_SECRET_KEY` - provided by Stripe Platform
- Edit `STRIPE_PUBLISHABLE_KEY` - provided by Stripe Platform
> 👉 **Step 3** - `Install dependencies`
```bash
$ virtualenv env
$ source env/bin/activate
$ pip install -r requirements.txt
```
> 👉 **Step 4** - `Start the App`
```bash
$ uvicorn src.app:app --reload
```
Visit `http://localhost:8000` in your browser. For another port, use `--port 8099` directive.
## ✨ Create a new Product
- Go to `src/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 `src/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:8000/products//` where the SLUG is the name of the JSON file
> Sample product page generated for [Air ZOOM Pegasus](./src/templates/products/air-zoom-pegasus.json), assets loaded from [here](./src/static/products/air-zoom-pegasus)
## ✨ Credits & Links
- [FastAPI Framework](https://fastapi.tiangolo.com/) - The official website
- [Stripe Dev Tools](https://stripe.com/docs/development) - official docs
---
[FastAPI & Stripe](https://blog.appseed.us/fastapi-stripe-free-ecommerce/) `Mini eCommerce` - Free sample provided by [AppSeed](https://appseed.us).