Pronto

Open-source business management for service businesses and retail shops.
Self-hosted via Docker or cloud at trypronto.app

What is Pronto?

Pronto replaces Excel and disconnected apps for small service businesses and retail shops.
Your clients book directly with you — no marketplace commission, no vendor lock-in.

Supported business types:
Salons · Barbershops · Spas · Dental clinics · Fitness studios ·
Auto repair shops · Cafes · Tattoo studios · Retail shops & kiosks

Features

📅 Booking & Calendar

Online booking page — clients book with name + phone only, no account required
Drag-and-drop calendar with staff color coding
Double-booking prevention (PostgreSQL trigger)
Zero commission — 100% of revenue goes to you

👥 CRM & Clients

Client cards with visit history, notes, tags, birthday
CSV import from Fresha, Vagaro, Booksy, Mindbody, Square

🛒 POS & Checkout

Fast checkout: services and products in one cart
Cash, card, transfer payment methods
Sales history with search by client

📦 Inventory & Retail

Product catalog with barcode, SKU, category, cost/sell price
Barcode scanner support (USB/Bluetooth keyboard-wedge mode)
Manual product grid for cashiers without a scanner
CSV/Excel import — auto-detects columns, supports .xlsx and .csv
Excel export for products and sales history
Low-stock alerts via Telegram, WhatsApp or Email
Stock movement history per product

🔔 Omnichannel Notifications (free, your own credentials)

Email (Resend / SMTP)
Telegram Bot
WhatsApp (Meta Cloud API)
Viber Bot
Auto-events: booking confirmation, 24h reminder, 1h reminder, thank-you, reactivation, birthday, low stock

⚙️ Modular System

Enable only what you need:

Preset	Modules enabled
Salon / Barbershop	Bookings + CRM + POS + Inventory + Notifications
Shop / Kiosk	POS + Inventory + Notifications (no booking calendar)
Cafe	POS + CRM + Inventory + Notifications

Toggle modules in Settings → Modules — unused tabs disappear from the sidebar.

📊 Analytics

Dashboard shows today's revenue with a 7-day sparkline
Full analytics dashboard (top services/products, client LTV, visit frequency) is cloud-only — see below

🌐 Multi-language

Interface available in English, Spanish (LatAm), Italian, Portuguese (Brazil)

Quick Start

Self-hosted (Docker)

Requirements: Docker, Docker Compose, a free Supabase account.

# 1. Clone the repo
git clone https://github.com/SGrappelli/pronto.git
cd pronto

# 2. Copy environment file and fill in your values
cp .env.example .env

# 3. Disable email confirmation in Supabase (required for self-hosted)
#    Dashboard → Authentication → Providers → Email → uncheck "Confirm email" → Save

# 4. Start — migrations run automatically on first start
docker-compose up -d

Open http://localhost:3000

Supabase Setup

Create a project at supabase.com
Copy your Database connection string (Session mode, port 5432) from
Project Settings → Database → Connection string and set it as DATABASE_URL in .env
Migrations are applied automatically when you run docker-compose up
Create a public storage bucket named inventory in
Supabase Dashboard → Storage → New bucket (required for product photos)
Copy your project URL and anon/service keys to .env

Customize email templates (optional) — replace Supabase's defaults with Pronto-branded HTML:

Template in Supabase	File
Reset Password	`supabase/email-templates/reset-password.html`
Confirm signup	`supabase/email-templates/confirm-signup.html`
Change Email Address	`supabase/email-templates/email-change.html`

Cloud (no setup required)

Start free at trypronto.app — no credit card, no commission.

A few features are cloud-only and not part of the self-hosted core:

Loyalty points program
Analytics dashboard

Security checklist after installation

After deploying, log into your Supabase project dashboard and check Advisors → Security Advisor. This project follows Postgres/Supabase RLS best practices in every migration, but Supabase's own advisor is the only way to confirm the live state of your specific database — including any objects that may have existed in your project before running these migrations, or custom changes you've made yourself. Fix anything flagged there before using this in production with real customer data.

Environment Variables

Copy .env.example to .env and fill in:

# Supabase (required)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# PostgreSQL connection string (for automatic migrations)
# Supabase Dashboard → Project Settings → Database → Connection string (Session mode)
DATABASE_URL=postgresql://postgres.[ref]:[password]@[host]:5432/postgres

# App
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Email notifications (choose one)
RESEND_API_KEY=re_xxxxxxxxxxxx
# or SMTP_HOST / SMTP_PORT / SMTP_USER / SMTP_PASS / SMTP_FROM

# Cron (protects /api/cron/notify)
CRON_SECRET=replace-with-random-string

Messenger credentials (Telegram, WhatsApp, Viber) are configured per-business in
Settings → Notifications — not in environment variables.

Tech Stack

Layer	Technology
Frontend	Next.js 14 + Tailwind CSS + shadcn/ui
Backend	Next.js API Routes
Database	Supabase (PostgreSQL) with RLS
Auth	Supabase Auth (Email + Google OAuth)
Storage	Supabase Storage (product photos)
Notifications	Resend/SMTP + Telegram Bot API + Meta WhatsApp Cloud API + Viber Bot API
i18n	next-intl — EN / ES / PT
Deployment	Docker Compose

Notifications

Notification Events

Trigger	Who receives it	Channel
Booking confirmed	Client	Email + WhatsApp
Booking confirmed	Business owner	Telegram + Viber
24h before appointment	Client	Email + WhatsApp + Telegram† + Viber†
24h before appointment	Business owner	Telegram + Viber
1h before appointment	Client	Email + WhatsApp + Telegram† + Viber†
1h before appointment	Business owner	Telegram + Viber
After visit completed	Client (thank-you + rebook link)	Email + WhatsApp + Telegram† + Viber†
30 days no visit	Client (re-activation)	Email + WhatsApp
Birthday	Client	Email + WhatsApp
Low stock alert	Business owner	Email + Telegram + Viber

† Client receives Telegram/Viber notifications only if they have linked their profile via /link {phone} in the bot.

Cron Setup

Call this endpoint every 15 minutes from cron-job.org (free):

GET https://yourdomain.com/api/cron/notify
Authorization: Bearer YOUR_CRON_SECRET

Or use the built-in pg_cron scheduler — edit supabase/migrations/007_cron_jobs.sql (replace YOUR_APP_URL and YOUR_CRON_SECRET), enable pg_cron and pg_net extensions in Supabase Dashboard, then run the file via SQL Editor.

Telegram Bot

Open @BotFather → /newbot → copy the token
In Pronto: Settings → Notifications → paste token → click Connect
Open your bot in Telegram → send /start

Owner commands: /today — today's appointments · /help — command list

Clients link their profile by sending /link +12345678900 to the bot (their booking phone number).

Viber Bot

⚠️ Since February 2024, new Viber bots require a commercial agreement (~€100/month). This integration works for bots created before February 2024. For new setups, Telegram is recommended (free).

Sign in to partners.viber.com → copy auth token
In Pronto: Settings → Notifications → paste token → click Connect

Clients link via /link +12345678900 in the bot.

WhatsApp (Meta Cloud API)

developers.facebook.com → create a Meta App → add WhatsApp product
Copy Phone Number ID and Access Token from WhatsApp → API Setup
Recommended: create a permanent token via Meta Business Manager → System Users → Generate Token with whatsapp_business_messaging + whatsapp_business_management permissions
Paste credentials in Settings → Notifications → WhatsApp and save

⚠️ Business-initiated messages (reminders, thank-you, birthday) require pre-approved Message Templates submitted through Meta Business Manager. Without them, these messages are silently dropped by Meta. Create templates at business.facebook.com → Account tools → Message templates.

Deployment

VPS / Server

git clone https://github.com/SGrappelli/pronto.git
cd pronto
cp .env.example .env
# Edit .env
docker-compose up -d

Point your domain to the server and set up a reverse proxy (Nginx, Caddy, or Cloudflare Tunnel).

Nginx example

server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Project Structure

pronto/
├── app/
│   ├── (auth)/          # Login, Register, Check email
│   ├── (dashboard)/     # POS, CRM, Inventory, Booking, Settings, Dashboard
│   ├── api/             # All API routes (notifications, cron, inventory, etc.)
│   ├── onboarding/      # First-run setup wizard
│   └── book/[slug]/     # Public booking page (no login required)
├── components/
│   ├── inventory/       # Import modal, barcode scanner UI
│   ├── layout/          # Sidebar, Header
│   └── ui/              # Button, Badge, Card, DatePicker...
├── hooks/
│   └── useBarcodeScanner.ts   # Keyboard-wedge barcode scanner hook
├── lib/
│   ├── modules.ts       # MODULES const — sidebar and feature gating
│   ├── plan-limits.ts   # All unlimited in self-hosted
│   ├── supabase/        # Client, Server helpers, database types
│   ├── email.ts         # Email templates + sending
│   ├── telegram.ts      # Telegram Bot API + templates
│   ├── viber.ts         # Viber Bot API + templates
│   ├── whatsapp.ts      # Meta WhatsApp Cloud API + templates
│   └── utils.ts         # Helpers (formatCurrency, formatDate…)
├── messages/
│   ├── en.json          # English strings
│   ├── es.json          # Spanish strings
│   ├── it.json          # Italian strings
│   └── pt.json          # Portuguese strings
├── supabase/
│   └── migrations/      # SQL files — applied automatically on first docker-compose up
├── .env.example
└── docker-compose.yml

Adding a New Language

Copy messages/en.json to messages/fr.json (or any locale code)
Translate all values
Update i18n/request.ts to include the new locale

Roadmap

✅ Current (v1.0)

POS + CRM + Booking + Inventory
Omnichannel notifications (Email, Telegram, WhatsApp, Viber)
Retail / barcode mode with CSV/Excel import-export
Modular system (enable only what you need)
Analytics dashboard
Multi-language: EN / ES / IT / PT
PWA with offline-capable POS
Docker one-command install

🔜 v1.5 — Q3 2026

Camera barcode scanning (BarcodeDetector API)
Label printing
Batch stock receiving
Open Food Facts integration (auto-fill product names by barcode)
LINE messenger

🌐 v2.0 — Q4 2026

Staff payroll & commissions
Multi-location support
AI insights
API access

Professional Services

Need help getting started?

Installation & setup — deploy Pronto on your server, configure all integrations ($100–200)
Customization — custom features, branding, or integrations for your specific business ($150–400)

Contact: ukv2179@gmail.com or open an issue with the services label.

Contributing

Pull requests welcome. Please open an issue first to discuss major changes.
See CONTRIBUTING.md for guidelines.

License

MIT — free for personal and commercial use.

Have a feature request? Open an issue

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
app		app
certs		certs
components		components
docs		docs
hooks		hooks
i18n		i18n
lib		lib
messages		messages
public		public
scripts		scripts
supabase		supabase
.env.example		.env.example
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
eslint.config.mjs		eslint.config.mjs
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
proxy.ts		proxy.ts
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

Pronto

What is Pronto?

Features

📅 Booking & Calendar

👥 CRM & Clients

🛒 POS & Checkout

📦 Inventory & Retail

🔔 Omnichannel Notifications (free, your own credentials)

⚙️ Modular System

📊 Analytics

🌐 Multi-language

Quick Start

Self-hosted (Docker)

Supabase Setup

Cloud (no setup required)

Security checklist after installation

Environment Variables

Tech Stack

Notifications

Notification Events

Cron Setup

Telegram Bot

Viber Bot

WhatsApp (Meta Cloud API)

Deployment

VPS / Server

Nginx example

Project Structure

Adding a New Language

Roadmap

✅ Current (v1.0)

🔜 v1.5 — Q3 2026

🌐 v2.0 — Q4 2026

Professional Services

Contributing

License

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages