Freemiusfast | Laravel & React Freemius SaaS Boilerplate

Freemiusfast is a professional-grade SaaS boilerplate designed specifically for developers selling web applications through the Freemius ecosystem. It combines the power of a Laravel backend with a modern React SPA frontend to create a seamless licensing and management experience.

✨ Features

• Freemius SDK Integration: Pre-configured logic for license validation, trial management, and subscription syncing.
• Modern Tech Stack: Laravel 12, React, and Inertia.js for a smooth Single Page Application (SPA) feel.
• Dynamic Menu System: Database-driven sidebar management with automatic active-state detection.
• Advanced RBAC: Robust Role-Based Access Control to restrict features based on license tiers (Free vs. Pro).
• Responsive UI: Beautiful dashboard built with Tailwind CSS and Lucide icons.

Freemius Setting

Inactive Plan Account

Active Plan Account

🛠 Installation

1. Clone the Repository

git clone https://github.com/naharsoftbd/freemiusfast-dev.git
cd freemiusfast-dev

2. Install Dependencies

Install PHP dependencies

composer install

Install JavaScript dependencies

npm install

3. Environment Setup

Create your environment file and generate the application key:

cp .env.example .env
php artisan key:generate
php artisan migrate:fresh --seed
php artisan user:create-admin

BROADCAST_CONNECTION=reverb

REVERB_APP_ID=34343
REVERB_APP_KEY=xxxxxxxxxxxxxxx
REVERB_APP_SECRET=xxxxxxxxxxxx
REVERB_HOST="127.0.0.1"
REVERB_PORT=8080
REVERB_SCHEME=http

VITE_REVERB_APP_KEY="${REVERB_APP_KEY}"
VITE_REVERB_HOST="${REVERB_HOST}"
VITE_REVERB_PORT="${REVERB_PORT}"
VITE_REVERB_SCHEME="${REVERB_SCHEME}"

4. Freemius Configuration

Add your Freemius developer credentials to your dashobard to enable licensing features:

5. Run necessary command

These commands very important for application

php artisan queue:work
php artisan reverb:start --host=127.0.0.1 --port=8080

🔑 Licensing Architecture

Freemiusfast utilizes a middleware-based approach to verify Freemiusfast licenses. This ensures that premium React components and Laravel routes are only accessible to authorized users.

Handshake: On Istallation, the app verifies the user's license key via the license API.

Caching: Subscription status is cached locally to ensure high performance and reduce API overhead.

Gatekeeping: The CheckLicense middleware intercepts requests to "Pro" features.

🤝 Contributing

Contributions are welcome! If you have ideas for better Freemius integration or UI improvements, please fork the repo and submit a pull request.

📄 License

This project is open-source software licensed under the GNU license.

**Would you like me to generate a LICENSE file or a .gitignore specifically optimized for a Laravel-Rea