An open API service indexing awesome lists of open source software.

https://github.com/mostafa-said7/starbucks

Starbucks Egypt is a full-stack-ready, production-grade frontend built as a faithful recreation.
https://github.com/mostafa-said7/starbucks

asp asp-net clean-architecture clean-code design-patterns entity-framework-core optimization pwa react responsive-design restful-api seo shadcn-ui solid-principles sql-server system-design tailwindcss vite

Last synced: 15 days ago
JSON representation

Starbucks Egypt is a full-stack-ready, production-grade frontend built as a faithful recreation.

Awesome Lists containing this project

README

          

# ☕ Starbucks Egypt

**Enterprise Full-Stack Commerce Platform**


A premium, enterprise-grade digital experience for Starbucks Egypt.

Built with React 19, ASP.NET Core 9.0, and Clean Architecture

to deliver high-performance, accessible, and bilingual (AR/EN) coffee commerce.



Frontend Deployment


Backend Status


License

---

## 🚀 Live Environments

Explore the application in real-time through our live deployment environments:

| Service | Environment | Live URL |
| :--- | :--- | :--- |
| **✨ Frontend App** | Production | [starbucks73.vercel.app](https://starbucks73.vercel.app) |
| **⚙️ Backend API** | Production | [starbucks.runasp.net/api](http://starbucks.runasp.net/api) |
| **📚 API Docs** | Swagger UI | [starbucks.runasp.net/swagger](http://starbucks.runasp.net/swagger) |

---

## 🏗️ Technical Pillar

Our technology stack is selected to provide a world-class, ultra-fast, and highly scalable user experience.





🎨 Frontend (Modern Stack)




⚙️ Backend (Robust Architecture)








  • Framework: React 19 + Vite


  • Styling: Tailwind CSS v4 (Glassmorphism & RTL support)


  • State/Data: TanStack Query v5 + Zustand


  • Animations: Framer Motion


  • Localization: i18next (Arabic / English)






  • Core: ASP.NET Core 9.0


  • Architecture: Clean Architecture & CQRS (MediatR)


  • Persistence: Entity Framework Core + SQL Server


  • Caching: Redis-backed sessions & response caching


  • Security: JWT Authentication & Identity





---

## 💻 Quick Start Guide

Want to run the project locally? Follow these simple steps.

### Frontend Setup
```bash
cd Frontend
npm install --legacy-peer-deps
npm run dev
```
> The frontend application will start on `http://localhost:5173`

### Backend Setup
```bash
cd Backend
# Start the database and Redis instances
docker-compose up -d

# Run the API server
dotnet run --project src/Starbucks.API
```
> The API will be available on `https://localhost:7082` (or your configured port). Check out `/swagger` for API documentation.

---

## 📂 Documentation Deep-Dive

For detailed insights into our technical decisions, system design, and deployment pipelines, please explore our dedicated documentation modules:

| Document | Description |
| :--- | :--- |
| [**🏗️ Architecture & Design**](docs/ARCHITECTURE.md) | Technical philosophy, system design, and project structure. |
| [**🛠️ Development Guide**](docs/DEVELOPMENT.md) | Local setup instructions, tech stack details, and coding standards. |
| [**✨ Features & Use Cases**](docs/FEATURES.md) | Checklist of platform capabilities and common user workflows. |
| [**🚢 Deployment Guide**](docs/DEPLOYMENT.md) | Production hosting configurations and CI/CD pipeline details. |
| [**🔒 Security Policy**](docs/SECURITY.md) | Security best practices, threat models, and audit results. |

---

## 🤝 Contributing & Support

We welcome contributions! Before submitting a Pull Request, please read our [Contributing Guide](docs/CONTRIBUTING.md) and review our [Code of Conduct](docs/CODE_OF_CONDUCT.md).

Need help or found a bug? Feel free to check the [Documentation Index](docs/README.md) or open a [GitHub Issue](issues).




Built with ❤️ for the Starbucks Egypt Community