Skip to content

🎉 Duo v0.1.0 - First Public Release

Pre-release
Pre-release

Choose a tag to compare

View all tags
@joshcirre joshcirre released this 29 Oct 18:47
· 31 commits to main since this release
v0.1.0
933d84b

Duo v0.1.0 - Local-First Syncing for Laravel & Livewire

First public release of Duo - a local-first IndexedDB syncing package for Laravel and Livewire applications.

📦 Package Information

This release includes:

  • Composer Package: joshcirre/duo - Laravel service provider and traits
  • NPM Package: @joshcirre/vite-plugin-duo - Vite plugin and client library

✨ Features

Core Functionality

  • 🔄 Automatic IndexedDB Syncing - Transparent client-side caching of Eloquent models
  • ⚡ Optimistic Updates - Instant UI updates with background server synchronization
  • 📡 Offline Support - Automatic offline detection with sync queue that resumes when back online
  • 🎯 Livewire Integration - Seamless integration with Livewire 3+ and Volt components
  • 🚀 Zero Configuration - Add one trait and Duo handles the rest

Full Page Caching

  • 💾 Offline Page Caching - Complete page caching with service workers
  • 🔧 Dynamic Service Worker - No publishing needed, served automatically from package
  • 🔒 CSRF Protection - @duoMeta directive includes CSRF token automatically
  • 🖼️ Asset Caching - Caches HTML, CSS, JS, images, and fonts for true offline mode

Developer Experience

  • 📊 Visual Sync Status - Built-in component showing online/offline/syncing states
  • 📦 Type-Safe - Full TypeScript support with auto-generated types
  • 🔌 Vite Plugin - Automatic manifest generation with file watching
  • 🧪 Workbench Demo - Fully functional todo list demo included

📚 Installation

Composer

composer require joshcirre/duo

NPM

npm install -D @joshcirre/vite-plugin-duo

🚀 Quick Start

  1. Add the Syncable trait to your models:
use JoshCirre\Duo\Syncable;

class Todo extends Model
{
    use Syncable;
}
  1. Add the WithDuo trait to your Livewire/Volt components:
use JoshCirre\Duo\WithDuo;

new class extends Component {
    use WithDuo;
    // ...
}
  1. Add @duoMeta to your layout:
<head>
    @vite(['resources/css/app.css', 'resources/js/app.js'])
    @duoMeta
</head>
  1. Configure Vite:
import duo from '@joshcirre/vite-plugin-duo';

export default defineConfig({
    plugins: [duo()],
});

That's it! Your app now has local-first syncing with offline support.

📖 Documentation

🙏 Acknowledgments

Built with:

  • Laravel
  • Livewire
  • Dexie.js
  • Vite

📄 License

MIT License - see LICENSE for details.

Note: This is a 0.x release, meaning the API may change before 1.0. Please report any issues on GitHub.

Assets 2
Loading