trizy

A new way to shop!

Download APK · Watch Demo Video · Report Bug · Request Feature

📔 Table of Contents

• About the Project
• Demo
• Screenshots
• Tech Stack
• Features
• Color Reference
• Getting Started
  • Installation
  • Environment Variables
• Usage
• Roadmap
• Contributing
• License
• Contact

🌟 About the Project

Trizy is a modern e-commerce platform that brings personalized shopping experiences to users. With AI powered suggestions, a modern cart system, and a user friendly interface, Trizy allows customers to explore, like, purchase and review products. The platform also includes a unique trial system. It allows users to test products for specific time periods.

🎬 Demo

Download the App

• 📱 Download APK

• 🛒 Purchases: You can use Stripe test cards to simulate purchases.

  • Example: Use card number 4242 4242 4242 4242 with any future expiration date and any CVC.
  • For more test card details, check Stripe's test card documentation.
  • After making a purchase, your order status will be marked as “pending.” If you are using your own server setup, you can use the admin panel (to be shared soon) to update your order status.
  • If you are not using your own server setup, your order status will automatically update to “delivered” within a maximum of 4 days. (depending on the order delivery date)

📷 Screenshots

---

Auth

Login Page	Register Page

---

Home

Home Page - Deals Section	Home Page - Best of Week Section

---

Search

Search Page

---

Product Feed

Product Feed	Product Filtering

---

Product Details

Product Details

---

Cart Page

Empty Cart	Cart with Products

---

Checkout

Checkout Page	Payment Page

---

Address

My Addresses	Create Address

---

Orders

My Orders	Order Details

---

Reviews

Leave a Review	Product Reviews

---

AI Suggestions

AI Suggestions Feed	AI Suggestion Details

---

Subscription

Subscription Benefits	Subscription Details

---

Trial Products

Trial Product Feed	Trial Details

---

Account

Account Page	Liked Products

🎯 Features

• BLoC
• MVVM
• DI
• GoRouter
• Modern UI Design
• Nested Category System
• Optimized Product Search System
• Trial Products
• AI Product Suggestions
• Stripe Payment
• SQLite (Drift) Local Database
• and many more...

👾 Tech Stack

Client

• Flutter

Server

• Node.js
• Express.js

Database

• MongoDB
• Redis

DevOps

• Railway

🎨 Color Reference

Color	Hex Code	Preview
Primary Color	#F34147
Primary Color Darker	#D8373D
Secondary Color	#FFFFFF
Text Color	#000000

‼️ Prerequisites

Note: If you want to setup your own server, read below. If you don't, you can skip this part.

You need to get the backend from: git clone https://github.com/demirelarda/TrizyBackend

Go to readme of backend to setup the server:

https://github.com/demirelarda/TrizyBackend/blob/master/README.md

After setting up the server, you can run it on your local machine or you can deploy it to anywhere. (detailed information in the readme of backend)

Next step is to setup the flutter project.

Getting Started

First of all, clone the project:

git clone https://github.com/demirelarda/TrizyApp.git

⚙️ Installation

Run these in your project folder's terminal:

You need to install the flutter packages:

flutter pub get

Generate files for drift local database:

flutter pub run build_runner build --delete-conflicting-outputs

🔑 Environment Variables

To run this project, you will need to add the following environment variables to your .env file.

First create a file in the main project folder named: .env (same level with your pubspec.yaml)

If you don't want to setup your own server, I have the following credentials for you to use:

STRIPE_PUBLISHABLE_KEY=pk_test_51QYkVh035QmbFUX7DbEHEikKmOetjTaWlDbxdiTtUwr1va85c9YIz3fA0BfnevLrS1odICjXSM29mbfXJyIzeds000ixWNliyz
BASE_BACKEND_URL=https://trizybackendlive-production.up.railway.app

I strongly recommend using your own server, because if the usage of the above resources' usage exceeds a certain limit, unfortunately, I may have to revoke the credentials I provided.

If you use your own server:

In your .env file put these:

STRIPE_PUBLISHABLE_KEY -> You can get this from Stripe via creating an account and using the test mode, see backend's readme for detailed information about Stripe.

BASE_BACKEND_URL -> Where you deploy the server, just use the URL without any parameters like this: https://example.com (App has the /api/route by default.)

File content should look like that:

STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key_here
BASE_BACKEND_URL=your_base_server_url_here

👀 Usage

You can run the app on any Android device & emulator or iOS simulator.

🧭 Roadmap

• Better error handling system
• Removing boilerplate code
• Using a networking package
• Creating a more interactive marketplace

👋 Contributing

Contributions are always welcome!

See contributing.md for ways to get started.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contact

Arda Demirel - LinkedIn - [email protected]