Download the PHP package offload-project/laravel-waitlist without Composer

Laravel Waitlist

A simple and flexible waitlist package for Laravel applications. Manage multiple waitlists with ease — perfect for beta programs, product launches, feature access, and more.

This package provides the core functionality without imposing any UI or API structure, giving you complete freedom to implement your own controllers, views, and API endpoints.

Features

• Multiple waitlists — Create and manage as many waitlists as you need
• Simple facade API — Clean, intuitive interface for managing waitlist entries
• Status tracking — Pending, invited, and rejected states
• Email verification — Optional opt-in verification before inviting users
• Event-driven notifications — Automatic invite + verification notifications, fully customizable
• Metadata support — Store custom data with each entry
• Invite-only integration — Optional bridge into offload-project/laravel-invite-only for token-based flows
• Type-safe — Full PHPStan compliance

Table of Contents

• Requirements
• Installation
• Quick Start
  • Single Waitlist
  • Multiple Waitlists
• Usage
  • Full API
  • Working With the Model
  • Custom Controller / Livewire
  • Custom Notifications
  • Email Verification
• Configuration
• Database Schema
• API Reference
• AI Coding Assistant Skill
• Testing
• Contributing
• Security
• License

Requirements

• PHP 8.3+
• Laravel 11/12/13

Installation

Quick Start

Single Waitlist

If you only need one waitlist, just start using it — a default waitlist is created automatically:

Multiple Waitlists

Create and manage multiple waitlists for different purposes:

Usage

Full API

Working With the Model

You can also work directly with the WaitlistEntry model:

Custom Controller / Livewire

Since this package doesn't include controllers, you can create your own to fit your needs:

Example Livewire component:

Custom Notifications

Publish the config file and change the notification class:

Create your custom notification:

To send invitations manually instead of automatically, disable auto-send:

Email Verification

Optionally require users to verify their email before they can be invited:

Or via environment variables:

When verification is enabled:

The package provides a verification route at /waitlist/verify/{token} by default. Configure the routes in your config:

To customize the verification notification:

Configuration

Database Schema

waitlists table

• id — Primary key
• name — Waitlist name
• slug — Unique identifier for referencing the waitlist
• description — Optional description
• is_active — Whether the waitlist is active (default: true)
• settings — JSON field for custom settings
• created_at / updated_at — Laravel timestamps

Indexed fields: slug, is_active

waitlist_entries table

• id — Primary key
• waitlist_id — Foreign key to the waitlist (nullable for default waitlist)
• name — User's name
• email — User's email (unique per waitlist)
• status — Status: pending, invited, or rejected
• invited_at — Timestamp when invited
• metadata — JSON field for custom data
• verification_token — Token for email verification (nullable)
• verified_at — Timestamp when email was verified (nullable)
• invitation_id — Optional FK to offload-project/laravel-invite-only invitation (nullable)
• created_at / updated_at — Laravel timestamps

Indexed fields: status, created_at, verification_token Unique constraint: ['waitlist_id', 'email'] (same email can join multiple waitlists)

API Reference

Facade Methods

Waitlist Model Methods

WaitlistEntry Model Methods

AI Coding Assistant Skill

This package ships a Laravel Boost skill so coding assistants (Claude Code, Cursor, etc.) follow the package's conventions when generating code. Install it in your app with:

The skill source lives at skills/SKILL.md.

Testing

Contributing

Contributions are welcome! Please see the documents below before getting started.

• Contributing Guide — setup, workflow, commit conventions, and PR process
• Code of Conduct — expectations for participation in this project

Security

• Security Policy — how to report a vulnerability privately

License

The MIT License (MIT). Please see License File for more information.