# LuxoCal — Comprehensive Platform Documentation

> LuxoCal is a premium, cloud-based appointment scheduling SaaS platform built for service-based businesses globally. Developed by YC Industries and governed under Belgian law, it enables any professional — from doctors and lawyers to beauticians and cleaners — to manage their bookings online with zero technical knowledge required.

---

## Company & Legal Information

- **Product Name:** LuxoCal
- **Website:** https://luxocal.com
- **Developer:** YC Industries (https://yc-i.com)
- **Contact Email:** info@LuxoCal.com
- **Governing Law:** Belgium
- **Dispute Resolution:** Courts of Belgium (exclusive jurisdiction)
- **Data Protection:** GDPR-compliant; Row Level Security (RLS) per tenant
- **Payment Processor:** Stripe
- **Refund Policy:** Strictly no refunds under any circumstances

---

## Business Model

LuxoCal operates on a **subscription-based SaaS model**:

1. **Free Trial** — New users receive a free trial period to explore all features.
2. **Paid Subscription** — After the trial, users subscribe to continue using the platform. Pricing is automatically detected based on the user's local currency.
3. **Stripe Integration** — All payments are securely processed through Stripe. Users can manage their subscription, upgrade, or cancel via the Stripe customer portal.
4. **No Refunds** — All subscription payments are final and non-refundable.

---

## Target Audience

LuxoCal is designed for **any service-based professional** or business that manages client appointments, including but not limited to:

- Doctors and medical practitioners
- Lawyers and legal consultants
- Beauticians, hairdressers, and barbers
- Cleaning services
- Tutors and coaches
- Therapists and counselors
- Consultants and freelancers
- Any professional who works by appointment

---

## Core Features

### Personalized Booking Link
Every business owner receives a unique, shareable booking URL (e.g., `luxocal.com/your-name`). This link can be shared via WhatsApp, Instagram, email, or any communication channel. Clients visit the link, choose an available date and time, fill in their details, and confirm the appointment — all without downloading any app.

### Works on Any Device
The booking interface is fully responsive and mobile-first. Whether a client is on a phone, tablet, or desktop computer, the experience is seamless and visually polished.

### Automatic Email Reminders
LuxoCal automatically sends email reminders to clients before their scheduled appointments, reducing no-shows. Business owners don't need to do anything — the system handles it entirely.

### Secure & Private
Each business tenant operates in its own isolated, secure environment. Data is protected with industry-standard Row Level Security (RLS) in Supabase. The platform does not use invasive tracking, marketing cookies, or third-party analytics — only essential cookies for session management and language preferences.

### Daily Data Backup
Every night, the system sends business owners a full export of their schedule as CSV and calendar (.ics) files via email. This ensures data safety even in the unlikely event of system downtime.

### Website Embed & Integration
Business owners can embed their booking calendar directly on their existing websites using three embed methods:
- **Popup Button** — A styled button that opens the booking page in an overlay modal.
- **Inline Embed** — An iframe that displays the full booking calendar directly within the page.
- **Simple Link** — A styled link/button that opens the booking page in a new tab.

Additionally, LuxoCal generates a **QR Code** for each business that can be printed on business cards, flyers, or displayed in-store. The platform also provides ready-to-paste **email signature HTML** for Outlook, Gmail, and Apple Mail.

### White-Label Branding
Business owners can upload their own logo and business name. Clients see the business's brand, not LuxoCal's. This creates a seamless, professional experience for end clients.

### Multi-Language Support
The entire platform — including the booking page, dashboard, settings, email notifications, and legal pages — is available in **8 languages**:
1. English (en)
2. Dutch / Nederlands (nl)
3. French / Français (fr)
4. German / Deutsch (de)
5. Spanish / Español (es)
6. Italian / Italiano (it)
7. Hebrew / עברית (he) — Right-to-left layout
8. Arabic / العربية (ar) — Right-to-left layout

Business owners can set their preferred language for system emails (confirmations, reminders, backups). The booking page language adapts based on the business owner's language setting.

### Scheduling Configuration
Business owners have full control over their schedule:
- Set appointment duration (customizable)
- Define business hours (start time, end time)
- Choose working days (any combination of the 7 days)
- Block specific time slots (e.g., daily lunch break)
- Set up recurring weekly blocks
- Add vacation / time-off periods with optional reasons

### Manual Override
Business owners can manually create appointments that override normal scheduling rules — for example, booking a client on a weekend, during vacation, outside business hours, or in an overlapping time slot. These are clearly marked as manual overrides in the system.

### Client Appointment Management
After booking, clients receive a confirmation email with a unique link to manage their appointment. They can view appointment details or cancel directly from this link.

### Custom SMTP Configuration
Business owners can optionally configure their own SMTP server so that confirmation and reminder emails are sent from their own email address (e.g., `appointments@yourbusiness.com`). If not configured, emails are sent from LuxoCal's default system address.

### Social Login
In addition to email/password authentication, business owners can sign in or sign up using:
- Google
- Facebook
- Microsoft

### Admin Panel
A dedicated admin interface allows platform administrators to manage all users, view user dashboards, and perform administrative actions across the system.

### Subscription Management
Business owners can manage their subscription directly within the settings page. The system detects pricing in the user's local currency and processes payments via Stripe's secure checkout. Users can refresh their subscription status and access the Stripe customer portal to manage billing.

---

## Technical Stack

- **Frontend:** React 18 + TypeScript + Vite
- **UI Framework:** shadcn/ui + Radix UI primitives + Tailwind CSS
- **Animations:** Framer Motion
- **Backend:** Supabase (PostgreSQL + Row Level Security + Edge Functions)
- **Authentication:** Supabase Auth (email/password, Google, Facebook, Microsoft OAuth)
- **Payments:** Stripe (checkout sessions, customer portal, subscription management)
- **Email:** Supabase Edge Functions with optional custom SMTP
- **Bot Protection:** Cloudflare Turnstile
- **Hosting:** Vercel (with security headers: HSTS, X-Frame-Options, CSP, etc.)
- **Routing:** React Router v6 (SPA with client-side routing)

### Supabase Edge Functions
The following serverless functions power the backend:
- `book-appointment` — Processes new appointment bookings
- `send-booking-email` — Sends confirmation emails to clients
- `notify-admin` — Notifies business owners of new bookings
- `daily-summary` — Sends nightly backup CSV/calendar files
- `create-checkout` — Creates Stripe checkout sessions
- `check-subscription` — Validates subscription status
- `customer-portal` — Generates Stripe customer portal URLs
- `detect-currency` — Auto-detects user's local currency for pricing
- `detect-language` — Detects user's preferred language
- `save-smtp` — Stores custom SMTP configuration securely
- `admin-actions` — Handles admin panel operations

---

## Frequently Asked Questions (FAQ)

**Q: What is LuxoCal?**
A: LuxoCal is a professional online appointment booking platform. It gives service-based businesses a personalized booking link that clients can use to book appointments 24/7 — no app download required.

**Q: Who is LuxoCal for?**
A: Any professional who works by appointment: doctors, lawyers, beauticians, cleaners, tutors, therapists, consultants, and more.

**Q: How much does LuxoCal cost?**
A: LuxoCal offers a free trial. After the trial, a paid subscription is required. Pricing is detected automatically based on your local currency. All payments are handled securely through Stripe.

**Q: Do my clients need to create an account?**
A: No. Clients simply visit your booking link, pick a date and time, enter their name, email, and phone number, and confirm. No account creation is required.

**Q: How do I share my booking link?**
A: You get a unique URL like `luxocal.com/your-name`. Share it via WhatsApp, Instagram, email, social media — anywhere. You can also embed a booking widget on your website or print a QR code on your business card.

**Q: Does LuxoCal send reminders?**
A: Yes. LuxoCal automatically emails clients before their appointment. You don't need to do anything.

**Q: Is my data secure?**
A: Yes. LuxoCal uses Row Level Security (RLS) to isolate each business's data. We don't sell, rent, or trade your personal information. The platform is GDPR-compliant and uses only essential cookies.

**Q: What languages does LuxoCal support?**
A: English, Dutch, French, German, Spanish, Italian, Hebrew, and Arabic. The interface adapts automatically, including full right-to-left (RTL) support for Hebrew and Arabic.

**Q: Can I use my own email address for sending confirmations?**
A: Yes. You can configure your own SMTP server in settings. If you don't, emails are sent from LuxoCal's default address.

**Q: Can I embed the booking calendar on my existing website?**
A: Yes. LuxoCal offers popup buttons, inline iframe embeds, simple link buttons, QR codes, and email signature HTML — all with ready-to-copy code snippets.

**Q: Can I cancel appointments?**
A: Yes. Both business owners (via the dashboard) and clients (via their confirmation email link) can cancel appointments.

**Q: What happens to my data if the system goes down?**
A: LuxoCal sends you a daily backup of your full schedule as CSV and calendar files to your email every night. Your data is always safe in your inbox.

**Q: Can I add my own logo and branding?**
A: Yes. Upload your logo and set your business name. Clients see your brand on the booking page.

**Q: What is the refund policy?**
A: All subscription payments are final and non-refundable. This applies regardless of the reason for cancellation.

**Q: What law governs LuxoCal?**
A: LuxoCal is governed by Belgian law. All disputes are resolved exclusively in the Courts of Belgium.

**Q: How do I contact LuxoCal?**
A: Email info@LuxoCal.com for any inquiries.

---

## Localized Summaries

### English
LuxoCal is a professional appointment booking platform that lets service-based businesses accept online bookings through a personalized link. Clients pick a date and time, enter their details, and receive automatic confirmation and reminder emails. Business owners get a full dashboard with daily and weekly calendar views, vacation management, blocked hours, and real-time notifications. The platform requires no technical skills, works on any device, and integrates seamlessly into existing websites. With white-label branding, daily data backups, and GDPR-compliant security, LuxoCal is the easiest way for professionals to manage their schedule.

### Nederlands (Dutch)
LuxoCal is een professioneel afspraakboekingsplatform waarmee dienstverlenende bedrijven online boekingen accepteren via een gepersonaliseerde link. Klanten kiezen een datum en tijd, vullen hun gegevens in en ontvangen automatisch een bevestigings- en herinneringsmail. Bedrijfseigenaren krijgen een compleet dashboard met dagelijkse en wekelijkse kalenderweergaven, vakantiebeheer, geblokkeerde uren en realtime meldingen. Het platform vereist geen technische kennis, werkt op elk apparaat en integreert naadloos met bestaande websites. Met white-label branding, dagelijkse gegevensback-ups en GDPR-conforme beveiliging is LuxoCal de eenvoudigste manier voor professionals om hun agenda te beheren.

### Français (French)
LuxoCal est une plateforme professionnelle de prise de rendez-vous qui permet aux entreprises de services d'accepter des réservations en ligne via un lien personnalisé. Les clients choisissent une date et une heure, saisissent leurs coordonnées et reçoivent automatiquement des e-mails de confirmation et de rappel. Les propriétaires d'entreprise bénéficient d'un tableau de bord complet avec des vues de calendrier quotidiennes et hebdomadaires, la gestion des congés, les heures bloquées et les notifications en temps réel. La plateforme ne nécessite aucune compétence technique, fonctionne sur tous les appareils et s'intègre facilement à tout site web existant. Avec la personnalisation de marque, les sauvegardes quotidiennes et une sécurité conforme au RGPD, LuxoCal est la solution la plus simple pour les professionnels qui souhaitent gérer leur emploi du temps.

### Deutsch (German)
LuxoCal ist eine professionelle Terminbuchungsplattform, mit der dienstleistungsorientierte Unternehmen Online-Buchungen über einen personalisierten Link annehmen können. Kunden wählen ein Datum und eine Uhrzeit, geben ihre Daten ein und erhalten automatisch Bestätigungs- und Erinnerungsmails. Geschäftsinhaber erhalten ein vollständiges Dashboard mit täglichen und wöchentlichen Kalenderansichten, Urlaubsverwaltung, gesperrten Zeiten und Echtzeit-Benachrichtigungen. Die Plattform erfordert keine technischen Kenntnisse, funktioniert auf jedem Gerät und lässt sich nahtlos in bestehende Websites integrieren. Mit White-Label-Branding, täglichen Datensicherungen und DSGVO-konformer Sicherheit ist LuxoCal der einfachste Weg für Fachleute, ihren Terminkalender zu verwalten.

### Español (Spanish)
LuxoCal es una plataforma profesional de reserva de citas que permite a los negocios basados en servicios aceptar reservas en línea a través de un enlace personalizado. Los clientes eligen una fecha y hora, ingresan sus datos y reciben automáticamente correos electrónicos de confirmación y recordatorio. Los propietarios de negocios obtienen un panel completo con vistas de calendario diarias y semanales, gestión de vacaciones, horarios bloqueados y notificaciones en tiempo real. La plataforma no requiere conocimientos técnicos, funciona en cualquier dispositivo y se integra perfectamente en sitios web existentes. Con marca blanca personalizable, copias de seguridad diarias y seguridad compatible con el RGPD, LuxoCal es la forma más sencilla para que los profesionales gestionen su agenda.

### Italiano (Italian)
LuxoCal è una piattaforma professionale per la prenotazione di appuntamenti che consente alle aziende di servizi di accettare prenotazioni online tramite un link personalizzato. I clienti scelgono data e ora, inseriscono i propri dati e ricevono automaticamente e-mail di conferma e promemoria. I titolari d'azienda dispongono di una dashboard completa con visualizzazioni giornaliere e settimanali del calendario, gestione delle ferie, ore bloccate e notifiche in tempo reale. La piattaforma non richiede competenze tecniche, funziona su qualsiasi dispositivo e si integra perfettamente nei siti web esistenti. Con branding white-label, backup giornalieri dei dati e sicurezza conforme al GDPR, LuxoCal è il modo più semplice per i professionisti di gestire la propria agenda.

### עברית (Hebrew)
LuxoCal היא פלטפורמה מקצועית לקביעת תורים המאפשרת לעסקים מבוססי שירות לקבל הזמנות מקוונות דרך קישור אישי. לקוחות בוחרים תאריך ושעה, מזינים את פרטיהם ומקבלים אוטומטית מיילים של אישור ותזכורת. בעלי עסקים מקבלים לוח בקרה מלא עם תצוגות יומיות ושבועיות של לוח השנה, ניהול חופשות, שעות חסומות והתראות בזמן אמת. הפלטפורמה אינה דורשת ידע טכני, עובדת על כל מכשיר ומשתלבת בצורה חלקה באתרי אינטרנט קיימים. עם מיתוג בהתאמה אישית, גיבויים יומיים של נתונים ואבטחה תואמת GDPR, LuxoCal היא הדרך הפשוטה ביותר לאנשי מקצוע לנהל את לוח הזמנים שלהם.

### العربية (Arabic)
LuxoCal هي منصة احترافية لحجز المواعيد تتيح للشركات القائمة على الخدمات قبول الحجوزات عبر الإنترنت من خلال رابط مخصص. يختار العملاء التاريخ والوقت، ويدخلون بياناتهم، ويتلقون تلقائيًا رسائل بريد إلكتروني للتأكيد والتذكير. يحصل أصحاب الأعمال على لوحة تحكم كاملة مع عروض يومية وأسبوعية للتقويم، وإدارة الإجازات، والساعات المحظورة، والإشعارات الفورية. لا تتطلب المنصة أي مهارات تقنية، وتعمل على أي جهاز، وتتكامل بسلاسة مع المواقع الإلكترونية الحالية. مع العلامة التجارية المخصصة، والنسخ الاحتياطية اليومية للبيانات، والأمان المتوافق مع GDPR، تعد LuxoCal الطريقة الأسهل للمهنيين لإدارة جدول مواعيدهم.

---

*This document was last updated on 2026-05-20. For the latest information, visit https://luxocal.com or contact info@LuxoCal.com.*