fake-store.mp4

Fakeshop

🎯 FletXShop – A minimalist e-commerce showcase app built with Flet and FletX.

🛍️ Sell items like stickers, t-shirts, hoodies, and caps in a clean, responsive interface — deployable on desktop, web, and mobile — all using Python only!

🔥 This app was developed as an advanced example of FletX usage and will be presented at PyCon Togo 2025 as part of a live demo.

📦 Key features:

• Multi-platform support (Web, Desktop, Mobile)
• Dynamic routing & state management with FletX
• Clean UI built with Flet controls
• Easy-to-extend project structure

About

This is a FletX application built with FletX a GetX-like tiny framework for Python and Flet. FletX provides state management, dependency injection, and routing capabilities similar to GetX in Flutter.

Features

• 🚀 Fast Development: Hot reload and rapid prototyping
• 🏗️ Clean Architecture: Separation of concerns with controllers, views, and services
• 💉 Dependency Injection: Automatic dependency management
• 🔄 State Management: Reactive state management with automatic UI updates
• 🗺️ Routing: Declarative routing with named routes
• 📱 Cross-platform: Run on web, desktop, and mobile

Project Structure

fakeShop/
├── app/
│   ├── controllers/     # Business logic controllers
│   ├── services/       # Business services and API calls
│   ├── models/         # Data models
│   ├── components/     # Reusable widgets
│   ├── pages/          # Application pages
│   └── routes.py       # App routing modules
├── assets/             # Static assets (images, fonts, etc.)
├── tests/              # Test files
├── .python-version     # Python dependencies
├── pyproject.toml      # Python dependencies
├── README.md           # Quick start README
└── main.py            # Application entry point

Getting Started 🚀

Prerequisites

• Python 3.12+
• pip (Python package manager)

Installation

1. Clone or download this project
2. Install dependencies:

   # Using pip
   pip install -r requirements.txt
   
   # NOTE: you can use your favorite python package manager (uv, poetry, pipenv etc...)

Running the Application

# Run with FletX CLI (recommended)
fletx run

# Or run directly with Python
python main.py

# Run in web mode
fletx run --web

# Run in desktop mode
fletx run --desktop

# Run with custom host and port
fletx run --host 0.0.0.0 --port 8080

Development

Creating New Components

# Create a new controller
fletx generate controller UserController

# Create a new Page (Screen)
fletx generate page UserView

# Create a new service
fletx generate service ApiService

# Create a new Widget (Component)
fletx generate component TaskItem

---

Author

pro2015

Version

0.1.0