Connect your own website.

You need: Laravel 10, 11 or 12 · PHP 8.1+ · a database Laravel can migrate

1. 1

   Install the package

   From your Laravel project folder:

   TerminalCopy

   composer require calmify/laravel

2. 2

   Set up the receiver

   Make sure APP_URL in .env is the exact public address of your site, including https:// and www if you use it. Then run the installer. It writes a private CALMIFY_API_KEY to .env, creates the calmify_posts table and opens the route POST /api/calmify/posts.

   Covers are saved on the public disk, so link it once if you haven’t already.

   TerminalCopy

   php artisan calmify:install
   php artisan storage:link

3. 3

   Show the posts on your site

   Posts are saved to calmify_posts with sanitized HTML. Calmify links to them at /blog/{slug} by default (change it with CALMIFY_POST_URL). Add the routes and a view:

   routes/web.phpCopy

   use Illuminate\Support\Facades\DB;
   
   Route::get('/blog', fn () => view('blog.index', [
       'posts' => DB::table('calmify_posts')->whereNotNull('published_at')->latest('published_at')->paginate(12),
   ]));
   
   Route::get('/blog/{slug}', fn (string $slug) => view('blog.show', [
       'post' => DB::table('calmify_posts')->where('slug', $slug)->whereNotNull('published_at')->firstOrFail(),
   ]));

   resources/views/blog/show.blade.phpCopy

   <article>
       <h1>{{ $post->title }}</h1>
       @if ($post->image_path)
           <img src="{{ Storage::url($post->image_path) }}" alt="{{ $post->image_alt }}">
       @endif
       {!! $post->content_html !!}
   </article>

4. 4

   Or copy posts into your own model

   Already have a blog? Listen for the PostReceived event and save each post where your site expects it. Laravel 11+ finds listeners in app/Listeners automatically. To change settings, run php artisan vendor:publish --tag=calmify-config.

   app/Listeners/CopyCalmifyPost.phpCopy

   <?php
   
   namespace App\Listeners;
   
   use App\Models\Post;
   use Calmify\Laravel\Events\PostReceived;
   
   class CopyCalmifyPost
   {
       public function handle(PostReceived $event): void
       {
           $p = $event->post;
           Post::updateOrCreate(['slug' => $p->slug], [
               'title' => $p->title,
               'body' => $p->content_html,
               'excerpt' => $p->meta_description,
               'cover' => $p->image_path,
           ]);
       }
   }

5. 5

   Get a pairing code in Calmify

   In your workspace, open Websites, choose your site and set the publishing destination to Custom API. Save, then click Connect under “Connect with a pairing code”.

   You get a code like CALM-XXXX-XXXX. It works once and expires after 10 minutes. If it runs out, click New code.

6. 6

   Pair your site

   Deploy first so the route is live, then run this on the server (or anywhere with the same .env). If you cache config, run php artisan config:cache afterwards.

   Back in Calmify, click I ran it, check the connection. Calmify tests your site and shows the connected address. From now on, articles you publish or schedule for this website arrive on your site.

   TerminalCopy

   php artisan calmify:pair CALM-XXXX-XXXX