DEV Community: Serg

Larafast Multi-Tenancy is Live — Here's Why I Built It

Serg — Tue, 28 Oct 2025 07:56:06 +0000

When I started building SaaS projects in Laravel, I hit the same wall every time.

Tenant management. Domain routing. Billing setup. Admin dashboards.

Each new app meant weeks of setup before writing a single line of code that actually mattered.

That’s when Larafast Multitenancy was born — a Laravel 12 + Filament 4 starter kit that helps you launch a multi-tenant SaaS in days instead of months.

🛠️ The Problem Every Laravel Developer Faces

If you’ve ever built a SaaS with multi-tenancy, you know how messy it gets.

You handle tenant isolation, subdomains, custom domains, and user roles.
Then you add billing, authentication, and email systems.
And suddenly you’ve spent three weeks just building infrastructure, not your product.

I wanted to stop wasting that time. I wanted something clean, production-ready, and easy to extend.

💡 The Turning Point

A year ago, I was building a small SaaS idea. It was supposed to take a weekend.
It took three weeks — because of tenancy logic, domain setup, and user management.

That moment changed everything.
I decided to build a starter kit that saves developers from that grind.
So I rewrote everything from scratch — clean code, tested architecture, and modern stack.

That became Larafast Multitenancy.

⚙️ What’s Inside

Here’s what comes built-in:

Tenant isolation (single or multi-database)
Domain and subdomain routing
Filament 4 admin dashboard
Stripe, Paddle, and LemonSqueezy billing
Custom branding for each tenant
Authentication with 2FA, email verification, and social login
SEO-friendly URLs and meta setup
REST API ready with Laravel Sanctum
Fully tested and ready for production

All built with Laravel 12, Livewire, and Tailwind 4.

🧩 Real Example — Directify Runs on It

I didn’t want to release theory.
So I used it myself — on Directify, my no-code directory website builder.

Directify runs entirely on Larafast Multitenancy.
Every user gets an isolated tenant, their own domain, and a separate environment.
No hacks. No duplicated code. Just clean multitenancy built right.

That was the moment I knew this kit worked.

💬 Final Words

If you’re tired of building tenancy logic from scratch every time, this kit will save you weeks.

I built it so you can focus on the parts users actually see — and ship faster.

👉 Get Larafast Multitenancy ($299 Launch Price)
Lifetime updates. No recurring fees. Premium support included.

📘 Built With

🧠 More From Me

Follow me on Twitter or check out Larafast if you want to build faster with Laravel.

How to Create an Online Directory

Serg — Thu, 27 Feb 2025 10:38:53 +0000

Creating an online directory has never been easier, thanks to no-code platforms like Directify. Whether you're looking to list local businesses, community resources, or specialized services, Directify offers a streamlined solution to build and manage your directory website without any coding expertise.

Why Choose Directify for Your Online Directory?

Directify is designed to simplify the process of creating professional directory websites. With its user-friendly interface and robust features, you can have your directory up and running in no time.

Key Features of Directify

No Coding Required: Build and customize your directory without any technical skills.
Customizable Themes: Choose from a variety of themes to design a unique look and feel for your directory.
SEO Optimization: Built-in SEO tools, including sitemaps and rich snippets, help improve your site's visibility on search engines.
Custom Domains: Connect your own domain to enhance your brand identity with a simple DNS setup.
Monetization: Easily set up paid listings by connecting payment platforms like Stripe or Lemon Squeezy, allowing you to accept payments directly from your directory.
Team Collaboration: Invite team members to collaborate on your directory, with the ability to manage roles and permissions through an intuitive interface.
Data Import/Export: Import listings, categories, and blog articles from CSV files, and export your data for future use.

Read about the steps on how to create directory with Directify here: https://directify.app/blog/how-to-create-an-online-directory/

7 Steps to Launch Your First Online Directory Website

Serg — Thu, 12 Dec 2024 19:45:15 +0000

Creating an online directory is easier than ever with no-code tools. Here’s how to get started:

Choose a Niche: Focus on a specific market with demand, like local yoga studios or eco-friendly services. Research keywords and competitors to find gaps you can fill.
Pick a No-Code Platform: Use tools like Directify, Softr, or Bubble to design your directory without coding. Consider features, pricing, and scalability.
Design the Layout: Customize your directory’s look, ensure usability with clear categories, and organize listings for easy navigation.
Optimize for SEO: Use clear URLs, meta titles, and schema markup to rank higher on search engines. Add fresh content regularly.
Monetize: Earn through premium listings, subscription plans, and ad space. Start simple and scale as your directory grows.
Add Content & Test: Populate with at least 50 listings, test on devices, and gather feedback for improvements.
Launch & Promote: Announce your directory via email and social media. Partner with businesses and leverage Google Ads for visibility.

Quick Comparison of No-Code Platforms

Platform	Starting Price	Best For	Key Features
Directify	$24.5/month	Directory-specific needs	Unlimited listings, built-in tools
Softr	$25/month	Beginners	Simple templates, fast setup
Bubble	$25/month	Advanced customization	High flexibility, steep learning curve
Webflow	$12/month	Design-focused users	Great for SEO, advanced styling

Start small, focus on user needs, and improve as you grow. With the right approach, your directory can become a go-to resource for your niche.

Read full article here https://directify.app/blog/7-steps-to-launch-your-first-online-directory-website/

My First No-Code SaaS Took off - $8K in 40 days

Serg — Fri, 06 Dec 2024 09:43:59 +0000

Hey guys. I wanted to share my journey with Directify, a no-code directory website builder I've been working on, and how it's absolutely crushed its first month.

The Backstory

Like many of you, I've been grinding on side projects for years. I started to sell Starter Kits by the beginning of the year, and among them I had Directory Starter Kit. One of my customers who bought that, asked me "Do you plan to have Directory as a SaaS one day, to not care about hosting, fully no-code, easy setup, templates, etc". That's when the idea poped out and Directify was born.

What is Directify?

It's a no-code platform that lets users:

Create directory websites in minutes
Add listings, categories, and search functionality
Add custom codes, styles,
Monetize through paid listings and ads

The Numbers

Revenue: $8199 in first 40 days
Users: 263
Directories created: 330
Listings added: 3647

Key Learnings

Solve a real problem people actually have
Price competitively (starts at $24.5/month)
Focus on user experience
Provide killer customer support

Challenges

Initial marketing was tough
Lots of late nights debugging
Constant feature improvements

Next Steps

Add more template designs
Provide more customizations
Expand marketing channels

Would love to hear your thoughts and experiences with no-code tools! Any questions about Directify, ask away.

10 Laravel Project Ideas For Beginners to Advanced Level in 2024

Serg — Fri, 13 Sep 2024 11:02:55 +0000

Laravel is one of the most popular PHP frameworks, known for its elegant syntax and powerful features. Whether you are just starting out or looking to enhance your skills, building projects is one of the best ways to learn. In this article, we’ll explore 10 Laravel project ideas that range from beginner to advanced levels, helping you take your skills to the next level in 2024.

Pro Tip: If you’re looking for a way to speed up your development process, consider using Larafast, a powerful Laravel starter kit that comes pre-configured with essential features, saving you time and effort on the setup.

Beginner Level

1. To-Do List Application

A simple to-do list application is a classic beginner project. This project will introduce you to the basics of Laravel, including routing, controllers, and views. You’ll learn how to create, read, update, and delete tasks using Eloquent ORM.

Key Features:

User authentication
Task CRUD (Create, Read, Update, Delete)
Task categorization

2. Personal Blog

Creating a personal blog is a great way to get familiar with Laravel’s features while building something you can actually use. This project will help you understand how to manage content and build a dynamic website.

Key Features:

Blog post CRUD
Tagging system
Comments section
Simple WYSIWYG editor

Boost Your Development: With Larafast, you can get your personal blog up and running in no time. It comes with built-in user authentication and a flexible admin panel, so you can focus on customizing your blog rather than starting from scratch.

3. Contact Form with Email Notifications

A contact form is a small but essential component of many web applications. This project will teach you how to handle form submissions, validate data, and send emails using Laravel’s Mail system.

Key Features:

Form validation
Sending emails using SMTP
Email templates with Markdown

Intermediate Level

4. Simple E-commerce Store

Building a simple e-commerce store is an excellent way to dive into more complex Laravel features. This project will introduce you to payment gateways, shopping carts, and product management.

Key Features:

Product catalog with categories
Shopping cart functionality
User authentication and profile management
Payment gateway integration (e.g., Stripe or PayPal)

Speed Up Your Development: Larafast can give you a head start on your e-commerce store. With pre-built modules for authentication, user roles, and even basic product management, you can focus on what matters—building a great shopping experience.

5. URL Shortener

A URL shortener like Bitly is a practical project that combines multiple Laravel features. You'll work with routing, controllers, and database management to create a tool that shortens long URLs into compact, shareable links.

Key Features:

URL shortening and redirection
Click tracking
User authentication for link management
Analytics dashboard

6. Event Management System

An event management system is a more complex project that involves managing events, registrations, and ticketing. This project will help you get comfortable with more advanced database relationships and user roles.

Key Features:

Event creation and management
User registration for events
Ticket generation and email notifications
Admin panel for event oversight

Advanced Level

Directory Templates: How to Pick the Best One for Your Project

Serg — Thu, 06 Jun 2024 16:55:16 +0000

Creating a directory website can be a time consuming task, but using the right directory templates can simplify the process significantly. This guide will help you dig deeper into Larafast Directories Boilerplate, by discussing the key factors to consider and the benefits of using customizable templates.

Check Larafast Directories for your next Directory Project

Why Directory Templates Matter

The Role of Templates in Directory Websites

Directory templates are designed to provide a directory structure for the future website, with functionality that is required for directory website, which is Categories, Product Listings, Admin Panel to manage everything. Some directories require subscription or one-time payments from users to list their product, so having a pre-built payment system is also a crucial case.

Benefits of Using Templates

Time Efficiency: Templates save time by providing pre-designed layouts and features, allowing you to focus on content and customization rather than starting from scratch.
Cost-Effective: Using a template can be more cost-effective than hiring a designer to create a custom site from the ground up.
Consistency: Templates ensure a consistent look and feel across your website, which is essential for maintaining a professional appearance.
Functionality: Many templates come with built-in features tailored for directory sites, such as search functionality, listing management, and user review systems.
Customizability: High-quality templates offer customization options that allow you to tailor the site to your specific needs without extensive coding knowledge.

Factors to Consider When Choosing a Template

Customization Options

When selecting a directory template, it's crucial to consider the level of customization it offers. A good template should allow you to adjust colors, fonts, layouts, and other design elements to match your brand identity. Look for templates with flexible customization across design part as well as coding flexibility.

Ease of Use

The ease of use of a template can significantly impact your development process. Choose a template that is user-friendly and comes with comprehensive documentation and support. A well-documented template will save you time and frustration, making it easier to implement and modify according to your needs.

SEO Optimization

SEO optimization is vital for any directory website to ensure that your listings appear in search engine results. Select a template that is built with SEO best practices in mind, such as fast loading times, mobile responsiveness, and clean code. Templates that include SEO tools or plugins can further enhance your site's visibility.

Why choose Larafast Directories?

Larafast Directories: Features and Benefits

Larafast Directories is a powerful and flexible directory template designed to help you create professional directory websites with ease. It offers a range of features tailored specifically for directory sites, making it an ideal choice for developers and businesses alike.

Features:

Product Listing management
Pre-defined popular Categories
Search accross categories and products
SEO optimization for Categories and Products
Automatic Sitemap generation to index pages on Google fast
Admin panel to mange categories, products, users, etc.
User Authentication and Dashboard
Payment System to manage paid listings
Blog
30+ Themes for every taste
Documentation and Support

Benefits:

Enhances user experience with a clean, intuitive interface
Saves time with pre-built components and layouts
Boosts SEO efforts with optimized code and structure

By selecting a template that meets your specific needs and goals, you can streamline the development process and create a site that not only looks great but also performs well. Make an informed choice and set the foundation for a successful directory project with the right template.

Get Larafast Directories

Track Unique User Visits and Match with Purchases

Serg — Wed, 08 May 2024 12:55:46 +0000

It's very important to understand from where users visiting the website and which visits turned into purchase from users.

In this tutorial I will show you how I track users unique visits and match them with their purchases when you don't have auth users.

Model and Migrations

Let's create a model and migrations first, to store our traffic data.

php artisan make:model Traffic -m

Add necessary columns to traffic migration file.

public function up(): void
{
    Schema::create('traffic', function (Blueprint $table) {
        $table->id();
        $table->ipAddress('ip');
        $table->string('uuid')->nullable();
        $table->string('url')->nullable();
        $table->string('ref')->nullable();
        $table->string('referer')->nullable();
        $table->string('utm_medium')->nullable();
        $table->string('utm_source')->after('utm_medium')->nullable();
        $table->string('utm_campaign')->after('utm_medium')->nullable();
        $table->json('data')->nullable();
        $table->timestamps();
    });
}

If you need to track more query params, feel free to add other columns here.

In the App\Models\Traffic.php cast the "data" to "json" or "array". In the data column we will store all request params, in case if some of them were not listed separately, to have everything collected.

protected $casts = ['data' => 'json'];

Columns explained

url we will store the current page url without query params.
ref, utm_medium, utm_source, utm_campaign columns will contain the values from the eponymous query params.
referer - we will store HTTP_REFERER to know from which website user came
data column will contain an array of all query params from the url.
uuid column will be the unique identifier for the user, will talk about it more below

Middleware

To track the params on user's each page visit, we will use a Middleware for that.

php artisan make:middleware TrafficMiddleware

Register your TrafficMiddleware

For Laravel 11

Add TrafficMiddleware::class to your bootstrap/app.php file

```php bootstrap/app.php
return Application::configure(basePath: dirname(DIR))
->withRouting(
...
)
->withMiddleware(function (Middleware $middleware) {
...
$middleware->web([
TrafficMiddleware::class
])
})
->withExceptions(function (Exceptions $exceptions) {
...
})->create();




**For Laravel 10**

Add TrafficMiddleware::class to your `app/Http/Kernel.php` file's web middleware group



```php app/Http/Kernel.php
protected $middlewareGroups = [
        ...
        'web' => [
            ...
            TrafficMiddleware::class,
        ],
]

TrafficMiddleware

As we do not have auth users, we should somehow identify unique users for visits. For that we will use uuid and store it in session.
I prefer to store it for 30 days, as users do not buy immediately, we still want to know from where they visited website for the first time.
Feel free to change that to any days you want.

```php TrafficMiddleware.php
if (request()->hasCookie('uuid')) {
$uuid = request()->cookie('uuid');
} else {
$uuid = Str::uuid()->toString();
Cookie::queue('uuid', $uuid, 60 * 24 * 30);
}

Traffic::create([
'ip' => $request->ip(),
'uuid' => $uuid,
'url' => Str::before($request->getRequestUri(), '?'),
'ref' => $request->get('ref') ?? $request->get('referrer'),
'utm_medium' => $request->get('utm_medium'),
'utm_source' => $request->get('utm_source'),
'utm_campaign' => $request->get('utm_campaign'),
'referer' => Str::before($request->server('HTTP_REFERER'), '?'),
'data' => $request->all(),
]);




Feel free to exclude any uri's that you don't want to store.

Full code for middleware. I cover it in try/catch in case something goes wrong, to not interrupt users visits.



```php TrafficMiddleware.php
<?php

namespace App\Http\Middleware;

use App\Models\Traffic;
use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Cookie;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Str;
use Symfony\Component\HttpFoundation\Response;

class TrafficMiddleware
{
    /**
     * Handle an incoming request.
     *
     * @param  \Closure(Request): (Response)  $next
     */
    public function handle(Request $request, Closure $next): Response
    {
        try {
            if (! Str::contains($request->getRequestUri(), [
                '/admin',
                '/livewire',
                '/lemon-squeezy',
                '/api',
            ])) {

                if (request()->hasCookie('uuid')) {
                    $uuid = request()->cookie('uuid');
                } else {
                    $uuid = Str::uuid()->toString();
                    Cookie::queue('uuid', $uuid, 60 * 24 * 30);
                }

                Traffic::create([
                    'ip' => $request->ip(),
                    'uuid' => $uuid,
                    'url' => Str::before($request->getRequestUri(), '?'),
                    'ref' => $request->get('ref') ?? $request->get('referrer'),
                    'utm_medium' => $request->get('utm_medium'),
                    'utm_source' => $request->get('utm_source'),
                    'utm_campaign' => $request->get('utm_campaign'),
                    'referer' => Str::before($request->server('HTTP_REFERER'), '?'),
                    'data' => $request->all(),
                ]);
            }

        } catch (\Exception $exception) {
            Log::error($exception);
        }

        return $next($request);
    }
}

Match visit with purchase

This example is made for LemonSqueezy orders, but can be used with any other payments provider.

When user makes a purchase, we need to match the purchase with the visit. For that we will use the uuid that we stored in session.

LemonSqueezy checkout url accepts custom params, so we will pass the uuid to the checkout url and LemonSqueezy will return it back to us in the webhook.

Add uuid to the checkout url

In your plans section, get the uuid from session and pass to the checkout url.

$uuid = request()->cookie('uuid');

$attributes['buy_now_url'] . '?checkout[custom][uuid]=' . $uuid;

To learn more about LemonSqueezy for Non-Auth Users check out the tutorial here

For Vue users, to be sure that cookie is available for the first visit, create a new route to get the uuid from the cookie and do async request to get the uuid.

const uuid = ref(null);

const getUuid = async () => {
    await axios.get("/api/uuid").then((response) => {
        uuid.value = response.data.uuid;
    });
}

onMounted(() => {
    getUuid();
});

To connect our purchase with the visit, we will store the uuid in the lemon_squeezy_orders table.

Add new column to the lemon_squeezy_orders table.

public function up(): void
{
    Schema::table('lemon_squeezy_orders', function (Blueprint $table) {
        $table->uuid('uuid')->after('id')->nullable();
    });
}

Inside the WebhookController, we will match the purchase with the visit. (check LemonSqueezy Webhooks for Non-Auth Users for more details)

Add the uuid to the order.

...
(new LemonSqueezy::$orderModel)->create([
    ...
    'uuid' => $payload['meta']['custom_data']['uuid'],
    ...
...

That's it! Now you can track your users visits and match them with their purchases.

LemonSqueezy Webhooks for Non-Auth Users in Laravel

Serg — Wed, 08 May 2024 12:51:58 +0000

Laravel LemonSqueezy package default webhooks are using billable model to store the orders in the database.
But what if you want to handle webhooks for non-auth users?

In this article, we will see how to handle LemonSqueezy webhooks for non-auth users in Laravel.

Step 1: Install LemonSqueezy

First, you need to install the LemonSqueezy package in your Laravel application.

composer require lmsqueezy/laravel

Check the all installation steps in the official documentation

Step 2: Change the billable columns to nullable in lemon_squeezy_orders table

In this example we are using the orders table to store the orders for non-auth users.

Schema::table('lemon_squeezy_orders', function (Blueprint $table) {
    $table->unsignedBigInteger('billable_id')->nullable()->change();
    $table->string('billable_type')->nullable()->change();
    $table->string('customer_id')->nullable()->change();

    $table->dropIndex(['billable_id', 'billable_type']);
});

Or modify them in main migration file after publishing them

php artisan vendor:publish --tag="lemon-squeezy-migrations"

I also track user name and emails from lemon squeezy orders, so I added these columns to the lemon_squeezy_orders table.

Schema::table('lemon_squeezy_orders', function (Blueprint $table) {
    $table->string('user_email')->nullable();
    $table->string('user_name')->nullable();
});

Step 3: Create a new route for webhooks

As default LemonSqueezy webhooks are using the billable model to store the orders in the database we need to create a new route for webhooks.

Create a new controller WebhookController

php artisan make:controller Webhooks/WebhookController --invoke

Create a new route for LemonSqueezy webhooks in your routes/web.php file.

use App\Http\Controllers\Webhooks\WebhookController;

Route::post('lemon-squeezy/webhook', WebhookController::class);

Step 4: Copy from LemonSqueezy WebhookController

Open vendor/lemonsqueezy/laravel/src/Http/Controllers/WebhookController.php file and copy the __construct(), __invoke() and handleOrderCreated() methods to your WebhookController.

You can extend your controller with LemonSqueezy Webhook Controller for the other methods if you don't need modifications there

For our case we need to modify our handleOrderCreated() method to store the orders for non-auth users.

Instead of $billable->orders() we will use LemonSqueezy::$orderModel to create the order in our database

Remove 'customer_id' => $attributes['customer_id'], from the $order array as we are not using the billable model.

Add user_email and user_name to the $order array.

public function handleOrderCreated(array $payload): void
{
    if (Schema::hasTable((new LemonSqueezy::$orderModel)->getTable())) {
        $attributes = $payload['data']['attributes'];

        $order = (new LemonSqueezy::$orderModel)->create([
            'lemon_squeezy_id' => $payload['data']['id'],
            'user_email' => $attributes['user_email'],
            'user_name' => $attributes['user_name'],
            'product_id' => $attributes['first_order_item']['product_id'],
            'variant_id' => $attributes['first_order_item']['variant_id'],
            'identifier' => $attributes['identifier'],
            'order_number' => $attributes['order_number'],
            'currency' => $attributes['currency'],
            'subtotal' => $attributes['subtotal'],
            'discount_total' => $attributes['discount_total'],
            'tax' => $attributes['tax'],
            'total' => $attributes['total'],
            'tax_name' => $attributes['tax_name'],
            'status' => $attributes['status'],
            'receipt_url' => $attributes['urls']['receipt'] ?? null,
            'refunded' => $attributes['refunded'],
            'refunded_at' => $attributes['refunded_at'] ? Carbon::make($attributes['refunded_at']) : null,
            'ordered_at' => Carbon::make($attributes['created_at']),
        ]);
    } else {
        $order = null;
    }
}

Event Listener

Remove OrderCreated::dispatch($billable, $order, $payload) as we are not using the billable model.

Instead of OrderCreated event you can listen for WebhookHandled event in your application.

Add LemonSqueezyEventListener if you need to do additional actions after the order is created.
For example you can send a welcome email with the steps how to use your app when user makes the order.

<?php

namespace App\Listeners;

...
use LemonSqueezy\Laravel\Events\WebhookHandled;

class LemonSqueezyEventListener
{
    ...
    public function handle(WebhookHandled $event): void
    {
        if ($event->payload['meta']['event_name'] === 'order_created') {
            Log::info('Event handled', ['event' => $event->payload['data']]);

            Notification::route('mail', $attributes['user_email'])
                ->notify(new WelcomeNotification($attributes['user_name']));
        }
    }
}

Zero-Downtime Deployment with Laravel Forge

Serg — Thu, 18 Apr 2024 09:48:26 +0000

Deploying web applications can be a repetitive and error-prone task. In this blog post, we'll introduce a Bash script designed to automate the deployment process for a web application hosted on a server. Let's dive into the details of the script and how it streamlines the deployment workflow.

Setup

Before diving into the deployment process, let's set up some initial configurations:

DOMAIN=example.com
PROJECT_REPO="your_github_repo_name"
AMOUNT_KEEP_RELEASES=5

RELEASE_NAME=$(date +%s--%Y_%m_%d--%H_%M_%S)
RELEASES_DIRECTORY=~/$DOMAIN/releases
DEPLOYMENT_DIRECTORY=$RELEASES_DIRECTORY/$RELEASE_NAME

These variables define crucial aspects such as the domain name, project repository, and the number of releases to keep.

Deployment Process

Cloning Repository and Setup

The script starts by creating a unique release directory and clones the project repository into it:

cd /home/forge/$DOMAIN

mkdir -p "$RELEASES_DIRECTORY" && cd "$RELEASES_DIRECTORY"

git clone "$PROJECT_REPO" "$RELEASE_NAME"
cd "$RELEASE_NAME"
git checkout "$FORGE_SITE_BRANCH"
git fetch origin "$FORGE_SITE_BRANCH"
git reset --hard FETCH_HEAD

Environment Setup

Next, the script copies the .env file from the project directory:

printf '\nℹ️ Copy ./.env file\n'
ENV_FILE=~/"$DOMAIN"/.env
if [ -f "$ENV_FILE" ]; then
  cp $ENV_FILE ./.env
else
  printf '\nError: .env file is missing at %s.' "$ENV_FILE" && exit 1
fi

Running Laravel Commands

$FORGE_COMPOSER install --no-dev --no-interaction --prefer-dist --optimize-autoloader

( flock -w 10 9 || exit 1
    echo 'Restarting FPM...'; sudo -S service $FORGE_PHP_FPM reload ) 9>/tmp/fpmlock

if [ -f artisan ]; then
    $FORGE_PHP artisan migrate --force
fi

Dependency Installation and Build

The script installs NPM dependencies and generates necessary files:

printf '\nℹ️ Installing NPM dependencies based on \"./package-lock.json\"\n'
npm install
printf '\nℹ️ Generating JS App files\n'
npm run build

Linking Deployment Directory

The script links the deployment directory to the current directory:

printf '\nℹ️ !!! Link Deployment Directory !!!\n'
echo "$RELEASE_NAME" >> $RELEASES_DIRECTORY/.successes
if [ -d ~/$DOMAIN/current ] && [ ! -L ~/$DOMAIN/current ]; then
  rm -rf ~/$DOMAIN/current
fi
ln -s -n -f -T "$DEPLOYMENT_DIRECTORY/public" ~/$DOMAIN/current

Clean Up

Lastly, the script performs clean-up tasks:

printf '\nℹ️ Delete failed releases:\n'
# Code for deleting failed releases

printf '\nℹ️ Delete old successful releases:\n'
# Code for deleting old successful releases

printf '\nℹ️ Status - stored releases:\n'
# Code for displaying stored releases

printf '\n✅ Deployment DONE: %s\n' "$DEPLOYMENT_DIRECTORY"

Full Script

# SETUP #
DOMAIN=yourdomain.com
PROJECT_REPO="git@github.com:your-team/repo.git"
AMOUNT_KEEP_RELEASES=5

RELEASE_NAME=$(date +%s--%Y_%m_%d--%H_%M_%S)
RELEASES_DIRECTORY=~/$DOMAIN/releases
DEPLOYMENT_DIRECTORY=$RELEASES_DIRECTORY/$RELEASE_NAME

# stop script on error signal (-e) and undefined variables (-u)
set -eu

printf '\nℹ️ Starting deployment %s\n' "$RELEASE_NAME"

cd /home/forge/$DOMAIN

mkdir -p "$RELEASES_DIRECTORY" && cd "$RELEASES_DIRECTORY"

printf '\nℹ️ Clone GIT project from %s and checkout branch %s\n' "$PROJECT_REPO" "$FORGE_SITE_BRANCH"
git clone "$PROJECT_REPO" "$RELEASE_NAME"
cd "$RELEASE_NAME"
git checkout "$FORGE_SITE_BRANCH"
git fetch origin "$FORGE_SITE_BRANCH"
git reset --hard FETCH_HEAD

printf '\nℹ️ Copy ./.env file\n'
ENV_FILE=~/"$DOMAIN"/.env
if [ -f "$ENV_FILE" ]; then
  cp $ENV_FILE ./.env
else
  printf '\nError: .env file is missing at %s.' "$ENV_FILE" && exit 1
fi

$FORGE_COMPOSER install --no-dev --no-interaction --prefer-dist --optimize-autoloader

( flock -w 10 9 || exit 1
    echo 'Restarting FPM...'; sudo -S service $FORGE_PHP_FPM reload ) 9>/tmp/fpmlock

if [ -f artisan ]; then
    $FORGE_PHP artisan migrate --force
fi

printf '\nℹ️ Installing NPM dependencies based on \"./package-lock.json\"\n'
npm install
printf '\nℹ️ Generating JS App files\n'
npm run build

printf '\nℹ️ !!! Link Deployment Directory !!!\n'
echo "$RELEASE_NAME" >> $RELEASES_DIRECTORY/.successes
if [ -d ~/$DOMAIN/current ] && [ ! -L ~/$DOMAIN/current ]; then
  rm -rf ~/$DOMAIN/current
fi
ln -s -n -f -T "$DEPLOYMENT_DIRECTORY/public" ~/$DOMAIN/current

# Clean Up
cd $RELEASES_DIRECTORY

printf '\nℹ️ Delete failed releases:\n'
if grep -qvf .successes <(ls -1)
then
  grep -vf .successes <(ls -1)
  grep -vf .successes <(ls -1) | xargs rm -rf
else
  echo "No failed releases found."
fi

printf '\nℹ️ Delete old successful releases:\n'
AMOUNT_KEEP_RELEASES=$((AMOUNT_KEEP_RELEASES-1))
LINES_STORED_RELEASES_TO_DELETE=$(find . -maxdepth 1 -mindepth 1 -type d ! -name "$RELEASE_NAME" -printf '%T@\t%f\n' | head -n -"$AMOUNT_KEEP_RELEASES" | wc -l)
if [ "$LINES_STORED_RELEASES_TO_DELETE" != 0 ]; then
  find . -maxdepth 1 -mindepth 1 -type d ! -name "$RELEASE_NAME" -printf '%T@\t%f\n' | sort -t $'\t' -g | head -n -"$AMOUNT_KEEP_RELEASES" | cut -d $'\t' -f 2-
  find . -maxdepth 1 -mindepth 1 -type d ! -name "$RELEASE_NAME" -printf '%T@\t%f\n' | sort -t $'\t' -g | head -n -"$AMOUNT_KEEP_RELEASES" | cut -d $'\t' -f 2- | xargs -I {} sed -i -e '/{}/d' .successes
  find . -maxdepth 1 -mindepth 1 -type d ! -name "$RELEASE_NAME" -printf '%T@\t%f\n' | sort -t $'\t' -g | head -n -"$AMOUNT_KEEP_RELEASES" | cut -d $'\t' -f 2- | xargs rm -rf
else
  AMOUNT_KEEP_RELEASES=$((AMOUNT_KEEP_RELEASES+1))
  LINES_STORED_RELEASES_TOTAL=$(find . -maxdepth 1 -mindepth 1 -type d -printf '%T@\t%f\n' | wc -l)
  printf 'There are only %s successfully stored releases, which is less than or equal to your\ndefined %s releases to keep, so none of them got deleted.' "$LINES_STORED_RELEASES_TOTAL" "$AMOUNT_KEEP_RELEASES"
fi

printf '\nℹ️ Status - stored releases:\n'
find . -maxdepth 1 -mindepth 1 -type d -printf '%T@\t%f\n' | sort -nr | cut -f 2-

printf '\n✅ Deployment DONE: %s\n' "$DEPLOYMENT_DIRECTORY"

Conclusion

Automation is key to improving deployment efficiency and reducing errors. By using this Bash script, you can streamline the deployment process for your web applications, saving time and ensuring consistency.

Laravel LemonSqueezy for Non-Auth Users

Serg — Wed, 27 Mar 2024 08:28:53 +0000

Extending LemonSqueezy to Non-Registered Users: A Practical Guide

When it comes to online shopping, making the checkout process as smooth as possible is crucial. Many Laravel developers rely on LemonSqueezy, a handy package for managing transactions. However, Laravel LemonSqueezy is primarily designed for registered users, which can be a problem for guests.

But fear not, there's a simple solution to make LemonSqueezy work for everyone, whether they're logged in or not.

By default, Laravel LemonSqueezy's checkout features are geared towards registered users. But what about those who are just browsing without an account? That's where the LemonSqueezyService comes into play. It's a nifty tool that allows you to extend LemonSqueezy's capabilities to non-registered users hassle-free.

To get started, make sure you've added the LemonSqueezyServiceProvider to your Laravel app. Once that's done, you can use the LemonSqueezyService to interact with LemonSqueezy's API and give non-registered users access to product payment links.

Add LemonSqueezy configs into services.php


    'lemonsqueezy' => [
        'base_url' => 'https://api.lemonsqueezy.com/v1',
        'key' => env('LEMON_SQUEEZY_API_KEY'),
        'store' => env('LEMON_SQUEEZY_STORE'),
    ],

Copy Service and ServiceProvider from the following Gist

https://gist.github.com/karakhanyans/95703b69322479c1968f41aeb8069aba

Or use Larafast Laravel Boilerplate which comes with LemonSqueezy and Stripe integrated.

Getting Product Info

The first step is fetching product details to display on your site. You can do this using the products() method:

app(LemonSqueezyService::class)->products();

Dealing with Variants

For products with different options or variants, or even those with just one price, you'll need to handle things a bit differently. The variants() method helps you fetch relevant information based on a specific product ID:

public function variants($productId)
{
    return $this->client->get('variants?filter[product_id]='.$productId)->json();
}

Generating Checkout URLs

For products with a single variant, you can use the buy_now_url attribute to create a direct checkout link. To include a discount code, simply append ?checkout%5Bdiscount_code%5D=YOUR_DISCOUNT_CODE to the URL.

$attributes['buy_now_url'].'?checkout%5Bdiscount_code%5D=YOUR_DISCOUNT_CODE'

For products with multiple variants, you'll need to generate checkout URLs dynamically using the checkout() method:

public function checkout($variant)
{
    // Implementation details
}

Example Implementation

Here's how you can use the LemonSqueezyService to fetch and display product information:

// Fetch products (cached for performance)
$products = Cache::rememberForever('lemonsqueezy-products', static fn () => app(LemonSqueezyService::class)->products());

// Process product data
$products = collect($products['data'])
    ->filter(fn ($product) => $product['attributes']['status'] === 'published')
    ->sortByDesc(fn ($product) => $product['attributes']['price'])
    ->map(function ($product) {
        // Processing logic
    });

// Use $products variable in your view files for display

By following these steps, you can provide a seamless shopping experience for both registered and non-registered users, leveraging the power of LemonSqueezy in your Laravel application.

Laravel SaaS Boilerplate

Serg — Thu, 07 Mar 2024 16:25:40 +0000

Hey Laravel Devs, I'm Serg, a Certified Laravel developer with 7 years of experience with the Framework.

I have combined my experience and knowledge in this SaaS boilerplate, with the latest technologies that all of you already love, like Filament, Tailwind, etc.

It has payments, admin, blog, SEO, user management, and a lot of beautiful Vue+Tailwind components to save you a lot of time.

Hope to hear your feedback.

Details -> https://larafast.com

DEV Community: Serg

Larafast Multi-Tenancy is Live — Here's Why I Built It

🛠️ The Problem Every Laravel Developer Faces

💡 The Turning Point

⚙️ What’s Inside

🧩 Real Example — Directify Runs on It

💬 Final Words

📘 Built With

🧠 More From Me

How to Create an Online Directory

Why Choose Directify for Your Online Directory?

Key Features of Directify

7 Steps to Launch Your First Online Directory Website

Quick Comparison of No-Code Platforms

My First No-Code SaaS Took off - $8K in 40 days

The Backstory

What is Directify?

The Numbers

Key Learnings

Challenges

Next Steps

10 Laravel Project Ideas For Beginners to Advanced Level in 2024

Beginner Level

1. To-Do List Application

2. Personal Blog

3. Contact Form with Email Notifications

Intermediate Level

4. Simple E-commerce Store

5. URL Shortener

6. Event Management System

Advanced Level

Directory Templates: How to Pick the Best One for Your Project

Why Directory Templates Matter

The Role of Templates in Directory Websites

Benefits of Using Templates

Factors to Consider When Choosing a Template

Customization Options

Ease of Use

SEO Optimization

Why choose Larafast Directories?

Larafast Directories: Features and Benefits

Track Unique User Visits and Match with Purchases

Model and Migrations

Columns explained

Middleware

Register your TrafficMiddleware

TrafficMiddleware

Match visit with purchase

Add uuid to the checkout url

LemonSqueezy Webhooks for Non-Auth Users in Laravel

Step 1: Install LemonSqueezy

Step 2: Change the billable columns to nullable in lemon_squeezy_orders table

Step 3: Create a new route for webhooks

Step 4: Copy from LemonSqueezy WebhookController

Event Listener

Zero-Downtime Deployment with Laravel Forge

Setup

Deployment Process

Cloning Repository and Setup

Environment Setup

Running Laravel Commands

Dependency Installation and Build

Linking Deployment Directory

Clean Up

Full Script

Conclusion

Top 3 questions people ask about Larafast

Laravel LemonSqueezy for Non-Auth Users

Extending LemonSqueezy to Non-Registered Users: A Practical Guide

Add LemonSqueezy configs into services.php

Getting Product Info

Dealing with Variants

Generating Checkout URLs

Example Implementation

Laravel SaaS Boilerplate