Skip to main content

​
What is BeanQuick?

BeanQuick is a comprehensive marketplace platform that connects coffee lovers with local coffee shops and businesses. Built with Laravel and React, BeanQuick enables customers to discover, order, and enjoy their favorite coffee products while empowering local businesses to manage their digital storefronts efficiently. BeanQuick Platform Overview

​
Key Features

BeanQuick offers a complete ecosystem for coffee commerce with three distinct user roles:

​
For Customers

Browse Coffee Shops

Discover local coffee businesses with detailed profiles, photos, and product catalogs

Smart Shopping Cart

Add products from multiple shops with real-time cart management

Order Management

Track orders, schedule pickup times, and view order history

Reviews & Ratings

Rate products and share feedback to help other coffee enthusiasts

​
For Coffee Businesses

Product Catalog

Manage your menu with images, descriptions, prices, and categories

Order Processing

Receive and manage customer orders with status tracking

Business Dashboard

Monitor sales, view analytics, and generate PDF reports

Store Control

Open/close your digital storefront with a single click

​
For Administrators

Business Approval

Review and approve new business registration requests

User Management

Manage users, roles, and permissions across the platform

Category Management

Create and organize product categories

Platform Oversight

Monitor businesses and ensure platform quality standards

​
Technology Stack

BeanQuick is built with modern, robust technologies: 
{
  "framework": "Laravel 12.0",
  "php": "^8.2",
  "authentication": "Laravel Sanctum",
  "pdf_generation": "DomPDF",
  "payment_gateway": "Mercado Pago"
}

​
Who is BeanQuick For?

Perfect for cafés, roasters, and coffee retailers looking to expand their digital presence. BeanQuick provides everything you need to showcase products, manage orders, and grow your business online without technical expertise.
Ideal for customers who want to discover and support local coffee businesses. Browse multiple shops, compare products, read reviews, and place orders for pickup - all in one convenient platform.
Designed for entrepreneurs who want to create a local coffee marketplace. The admin tools make it easy to onboard businesses, manage the community, and maintain quality standards.
Great for developers looking to learn or extend a modern Laravel-React application. BeanQuick demonstrates best practices including API development, authentication, file uploads, payment integration, and more.

​
Core Capabilities

​
Multi-Role Authentication

BeanQuick uses Laravel Sanctum for secure, token-based authentication supporting three user roles:
  • Cliente (Customer) - Browse, shop, order, and review
  • Empresa (Business) - Manage products, orders, and business profile
  • Admin - Platform administration and business approval

​
Payment Processing

Integrated with Mercado Pago for secure payment processing with automatic webhook handling for order status updates.

​
Real-Time Features

  • Live cart synchronization across devices
  • Real-time order status updates
  • Dynamic store open/closed status
  • Instant product availability updates

​
Business Registration Flow

1

Submit Application

Businesses submit registration requests with their details and documentation
2

Admin Review

Platform administrators review and approve/reject applications
3

Email Activation

Approved businesses receive an activation email with a secure token
4

Account Setup

Complete profile setup and start adding products immediately

​
Platform Architecture

BeanQuick follows a monorepo structure with separate backend and frontend: 
BeanQuick/
├── back-end/          # Laravel 12 API
│   ├── app/
│   │   ├── Http/Controllers/
│   │   ├── Models/
│   │   └── ...
│   ├── database/
│   ├── routes/
│   └── composer.json
│
└── front-end/         # React + Vite SPA
    ├── src/
    │   ├── pages/
    │   ├── components/
    │   └── App.jsx
    └── package.json

​
Next Steps

Ready to get started? Follow our comprehensive guides:

Quickstart

Get BeanQuick running locally in under 10 minutes

Installation

Detailed installation instructions for production deployment

API Reference

Explore all available API endpoints and authentication

Configuration

Configure database, payments, and environment settings
Local Development: BeanQuick runs entirely on localhost by default. The backend serves on http://127.0.0.1:8000 and the frontend on http://localhost:5173.

​
Support & Community

Documentation

Comprehensive guides and API references

GitHub Repository

Access source code and report issues

Contributing

Help improve BeanQuick for everyone
BeanQuick is built with scalability in mind. Whether you’re starting with a single coffee shop or building a city-wide marketplace, the platform grows with your needs.

Build docs developers (and LLMs) love

Get started for freeTalk to us