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.

Inactive Plan Account

Active Plan Account

🛠 Installation

1. Clone the Repository

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

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

4. Freemius Configuration

Add your Freemius developer credentials to your .env file to enable licensing features:

VITE_FREEMIUS_PRODUCT_ID="----"
VITE_FREEMIUS_API_KEY="---"
VITE_FREEMIUS_SECRET_KEY="---"
VITE_FREEMIUS_PUBLIC_KEY="---"
VITE_FREEMIUS_PUBLIC_URL='http://127.0.0.1:8000'
VITE_FREEMIUS_BASE_URL='---'
VITE_FREEMIUS_PLAN_ID="---"
VITE_FREEMIUS_API_BASE_URL='---'

🔑 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