Skip to content

Synapsr/Louez

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

845 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 Language: Français | English

🏠 Louez

The Open-Source Equipment Rental Platform

Stop paying for expensive SaaS. Own your rental business software.

Docker GitHub Stars License

☁️ Cloud β€’ πŸš€ Self-Host β€’ ✨ Features β€’ πŸ“‹ Changelog


🎬 Demo

See Louez in action β€” from setup to first booking


πŸ’‘ Why Louez?

Whether you rent cameras, tools, party equipment, or vehicles β€” Louez gives you everything you need to run your rental business professionally.

πŸ‡«πŸ‡· "Louez" means "rent" in French β€” because great software deserves a name that speaks to its purpose.

πŸ’Έ No Monthly Fees 🎨 Beautiful Storefronts πŸ”’ Own Your Data
Self-host for free. No subscriptions, no per-booking fees. Every store gets a stunning, customizable online catalog. Your server, your database, your customers.
⚑ Deploy in Minutes 🌍 Multi-language πŸ“± Mobile Ready
One command and you're live β€” database included. 8 languages built-in: EN, FR, DE, ES, IT, NL, PL, PT. Responsive design for all devices.

☁️ Cloud or Self-Hosted β€” You Choose

☁️ Louez Cloud

Don't want to manage servers?

We handle hosting, updates, backups, emails, payments & the AI assistant for you.

Get started free β†’ louez.io

πŸ–₯️ Self-Hosted

Want full control?

Deploy on your own infrastructure. 100% free, forever.

Deploy now ↓


πŸš€ Self-Host in One Command

git clone https://github.com/Synapsr/Louez.git
cd Louez
docker compose up -d

That's it. Open http://localhost:3000, create your account, and set up your store. Your storefront goes live at the root of the site; your dashboard lives at /dashboard.

The bundled docker-compose.yml is a complete, self-contained deployment:

  • πŸ—„οΈ Database included β€” MySQL runs alongside the app, and the schema installs itself on first boot
  • πŸ–ΌοΈ Image storage included β€” a private MinIO bucket, served through the app (no extra ports, no CDN setup)
  • πŸ”‘ No secrets to generate β€” an auth secret is created and persisted automatically
  • βœ‰οΈ No email server required β€” sign in with a password; plug in any SMTP provider later to enable outgoing email
  • πŸͺ Single-store mode β€” the instance hosts your store, not a SaaS

Using your own domain

Point a reverse proxy (Caddy, Nginx, Traefik) with TLS at port 3000 and set two variables in a .env file next to the compose file:

NEXT_PUBLIC_APP_URL="https://rentals.example.com"
AUTH_URL="https://rentals.example.com"

One-click platforms

The published image synapsr/louez runs in single-store mode by default β€” provide a MySQL database plus the variables above and it boots on EasyPanel, Dokploy, Coolify, Portainer or Railway. See .env.example for the full configuration surface (S3 storage, SMTP, Stripe, and more).

Multi-tenant deployments

Louez can also run as a multi-store platform (the way louez.io does): one dashboard subdomain, one storefront per store subdomain. Set LOUEZ_MODE=platform plus the domain variables documented in .env.example.

⬆️ Upgrading an existing multi-store self-host? Add LOUEZ_MODE=platform to your environment to keep subdomain routing β€” newer images default to single-store mode.


✨ Features

πŸ“Š Powerful Dashboard

Everything you need to manage your rental business in one place.

Feature What it does
πŸ“¦ Products Manage inventory with images, flexible pricing tiers, and stock tracking
πŸ“… Reservations Handle bookings, track status, manage pickups & returns
πŸ—“οΈ Calendar Visual week/month view of all your reservations
πŸ‘₯ Customers Complete customer database with history
πŸ“ˆ Statistics Revenue charts, top products, occupancy insights
πŸ“„ Contracts Auto-generated PDF contracts
βœ‰οΈ Emails Automated confirmations, reminders & notifications
πŸ‘¨β€πŸ‘©β€πŸ‘§β€πŸ‘¦ Team Invite staff with role-based permissions

πŸ›οΈ Stunning Storefronts

Each rental business gets its own branded online store.

  • 🎨 Custom Branding β€” Logo, colors, light/dark theme
  • πŸ“± Product Catalog β€” Filterable grid with real-time availability
  • πŸ›’ Shopping Cart β€” Date selection, quantities, dynamic pricing
  • βœ… Checkout β€” Customer form, order summary, terms acceptance
  • πŸ‘€ Customer Portal β€” Passwordless login, reservation tracking
  • πŸ“œ Legal Pages β€” Editable terms & conditions

πŸ€– AI Assistant

Louez ships a full AI layer that works for your store around the clock.

  • πŸ’¬ Storefront AI advisor β€” a chat assistant on your storefront that recommends the right gear from your live catalog, checks real availability for the customer's dates, answers questions about your hours and policies, and guides visitors all the way to booking. You brief it in plain language, like a new employee.
  • πŸ“ž AI voice receptionist β€” an assistant that answers your store's phone line: it handles questions about products, prices and availability, takes booking requests you review from the dashboard, sends the caller an SMS recap, and can hand over to a human. Pick its voice (with audio preview), its language (8 supported), and whether it answers every call or only outside opening hours. You can even get a phone number without leaving the dashboard.
  • πŸŽ›οΈ One control panel β€” configure both assistants, replay conversations and calls, and see which chats turned into reservations.

The AI assistant is available out of the box on Louez Cloud. Self-hosters can connect their own AI and telephony providers β€” the configuration lives in .env.example.


πŸ› οΈ Development Setup

Want to customize or contribute? Here's how to run locally:

# Clone the repo
git clone https://github.com/Synapsr/Louez.git
cd Louez

# Install dependencies
pnpm install

# Configure environment (creates .env.local at root and in apps/web)
cp .env.example .env.local
cp apps/web/.env.example apps/web/.env.local

# Setup database
pnpm db:push

# Start dev server
pnpm dev

Open http://localhost:3000 πŸŽ‰


πŸ—οΈ Tech Stack

Built with modern, battle-tested technologies:

Technology Purpose
⚑ Next.js 16 React framework with App Router
πŸ“˜ TypeScript Type-safe development
🎨 Tailwind CSS 4 Utility-first styling
🧩 Base UI Accessible UI primitives
πŸ—„οΈ Drizzle ORM Type-safe database queries (MySQL)
πŸ” better-auth Authentication (password, email codes, Google)
βœ‰οΈ React Email Beautiful email templates
πŸ“„ React PDF Contract generation
🌍 next-intl Internationalization

πŸ“– Documentation

πŸ“‹ Environment Variables

The bundled docker-compose deployment configures all of the required variables for you. For custom deployments:

Variable Required Description
DATABASE_URL βœ… MySQL connection string
NEXT_PUBLIC_APP_URL βœ… Public URL of your app
NEXT_PUBLIC_APP_DOMAIN βœ… Public domain of your app
AUTH_URL βœ… URL users sign in from (usually the app URL)
AUTH_SECRET Random secret (auto-generated by the compose deployment)
S3_* S3-compatible storage for images (bundled MinIO in compose)
LOUEZ_MODE standalone (default) or platform (multi-tenant routing)
SMTP_* Outgoing email β€” optional; email features disable gracefully
AUTH_GOOGLE_ID / AUTH_GOOGLE_SECRET Google sign-in β€” optional
STRIPE_* Online payments β€” optional; storefronts fall back to booking requests

Advanced integrations (AI providers, telephony, SMS, analytics, calendar sync…) are documented in .env.example.

πŸ“ Project Structure
louez/
β”œβ”€β”€ apps/
β”‚   β”œβ”€β”€ web/               # Next.js app (dashboard + storefronts + API)
β”‚   β”‚   β”œβ”€β”€ app/           # App Router routes
β”‚   β”‚   β”œβ”€β”€ components/    # Dashboard & storefront components
β”‚   β”‚   β”œβ”€β”€ lib/           # Business logic, email, PDF, AI
β”‚   β”‚   └── messages/      # i18n translations (8 languages)
β”‚   └── voice-relay/       # Optional streaming voice bridge (AI receptionist)
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ api/               # oRPC routers & services
β”‚   β”œβ”€β”€ auth/              # better-auth configuration
β”‚   β”œβ”€β”€ db/                # Drizzle schema & migrations (MySQL)
β”‚   β”œβ”€β”€ email/             # Email transport & templates
β”‚   β”œβ”€β”€ ui/                # Shared UI components
β”‚   └── ...                # types, utils, validations, pdf, config
└── docker/                # Production Dockerfiles & entrypoint
πŸ”§ Available Scripts
pnpm dev          # Start development server
pnpm build        # Build for production
pnpm start        # Start production server
pnpm lint         # Run the linter
pnpm format       # Format the codebase
pnpm type-check   # Type-check the monorepo
pnpm db:push      # Sync schema to database
pnpm db:studio    # Open Drizzle Studio GUI
pnpm db:generate  # Generate migrations
pnpm db:migrate   # Run migrations

🀝 Contributing

We love contributions! Here's how you can help:

  • πŸ› Report bugs β€” Found an issue? Let us know
  • πŸ’‘ Suggest features β€” Have an idea? Open a discussion
  • πŸ”§ Submit PRs β€” Code contributions welcome
  • πŸ“– Improve docs β€” Help others get started

Development Workflow

# Fork & clone
git clone https://github.com/YOUR_USERNAME/louez.git

# Create branch
git checkout -b feature/amazing-feature

# Make changes & commit
git commit -m 'Add amazing feature'

# Push & open PR
git push origin feature/amazing-feature

πŸ”’ Security

Found a vulnerability? Please report it responsibly.

πŸ“§ Email: security@louez.io

See SECURITY.md for our full security policy.


πŸ“„ License

Apache 2.0 with Commons Clause β€” see LICENSE

βœ… Free for personal and internal use βœ… Modify and customize freely βœ… Contributions welcome ❌ Cannot sell as a commercial service without agreement


⭐ Star us on GitHub!

If Louez helps your business, show some love with a star.

Star on GitHub


Built with ❀️ by Synapsr

Report Bug β€’ Request Feature β€’ Documentation

About

🏠 Open-source equipment rental platform. Manage inventory, reservations, customers & generate contracts. Beautiful storefronts for your rental business. Self-host for free or use our cloud. Built with Next.js, TypeScript & Tailwind.

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages