A minimal, responsive e-commerce storefront built with React and Vite. Designed as a live portfolio demo by Amir Fallahi — browse products, save favourites, manage a cart, and walk through a three-step checkout flow.
Live demo: devamir99.github.io/fakestore-app
Home page · dark theme
Home page · light theme
Product detail · dark theme
Product detail · light theme
- Product catalogue with search, category, price, and rating filters
- Product detail pages with related items
- Shopping cart with persistent local storage
- Favourites / wishlist
- Three-step checkout (front-end demo — no real payments)
- Dark and light themes
- Cream-and-coffee visual identity
- Mobile-first responsive layout
- React 19 · Vite 7 · Tailwind CSS 4
- React Router 7
- Local JSON product data (no external API dependency)
git clone https://github.com/devamir99/fakestore-app.git
cd fakestore-app
npm install
npm run devOpen http://localhost:5173.
Copy env.example to .env and optionally set:
| Variable | Purpose |
|---|---|
VITE_SITE_URL |
Production URL for Open Graph meta tags |
| Command | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Production build |
npm run preview |
Preview production build locally |
npm run lint |
Run ESLint |
This project is configured for GitHub Pages via GitHub Actions (.github/workflows/deploy-pages.yml).
- Push to the
mainbranch (or run the workflow manually) - In the repo: Settings → Pages → Source → GitHub Actions
- After the workflow succeeds, open:
https://devamir99.github.io/fakestore-app
Vite base is set to /fakestore-app/ for project-site hosting. The build also copies index.html → 404.html so SPA routes work on refresh.
This repository is a demonstration storefront. For a production-ready shop tailored to your brand, catalogue, and backend:
- Phone: +98 920 500 7494
- LinkedIn: linkedin.com/in/devamir
- Email: devamir99@gmail.com
- GitHub: github.com/devamir99
MIT — see LICENSE.