Duo v0.2.0 — Livewire 4, real offline, no REST layer

Duo is local-first Livewire: your component reads from IndexedDB, applies changes optimistically, and keeps working offline — while your own Livewire methods remain the only thing that writes to your database.

This release is a rewrite of the sync architecture and drops Livewire 3. Upgrade both packages together:

• Composer: joshcirre/duo ^0.2
• NPM: [@joshcirre](https://github.com/joshcirre)/vite-plugin-duo ^0.2

What changed

• Livewire 4 only. Class-based and single-file components. Laravel 12.
• Writes go through your Livewire methods. No more /api/duo/{table} endpoints. Duo writes an optimistic record, then calls your real $wire method; the server reports the Eloquent operations that ran and the client reconciles. Validation, policies, and events work exactly as in plain Livewire.
• Optimistic changes roll back when the server did not perform them — a failed validation removes the temp row while Livewire renders the error.
• Offline actions are queued (localStorage) and replayed through $wire when you're back online, including after a reload.
• Offline page loads work: with [@duoMeta](https://github.com/duoMeta) in your layout, the service worker caches visited pages and the component boots from IndexedDB with no network.
• The Alpine duo scope is added server-side, so there is no client-side DOM rewriting and no "duo is not defined" race.
• Method analysis detects toggles, $this->prop → column mappings, and literal defaults for accurate optimistic rendering.

Verified in a real browser

Against the workbench demo in headless Chromium: optimistic create/toggle/delete, validation rollback with Livewire-rendered errors, offline queue + replay, recovery from a killed server, replay of a previous session's queue on load, and a full page load with the server down.

Upgrading from 0.1.x

1. composer require joshcirre/duo:^0.2 and npm install -D [@joshcirre](https://github.com/joshcirre)/vite-plugin-duo@^0.2
2. Requires livewire/livewire ^4.0.
3. Add data-duo-* markers to the lists you want rendered from IndexedDB (see the README). Components with WithDuo alone still get page caching and offline action replay.
4. Remove any code that called /api/duo/* or window.duo.getSyncQueue() (still present as an alias for the action queue).
5. Clear browsers' IndexedDB once (<x-duo::debug /> → Delete Database) if you were running 0.1.x locally.

See the CHANGELOG for the full list, and the README for the marker reference and known limitations.

Note: 0.x — the marker vocabulary and JavaScript API may still change.

Full Changelog: https://github.com/joshcirre/duo/compare/v0.1.6...v0.1.7

Full Changelog: https://github.com/joshcirre/duo/compare/v0.1.5...v0.1.6

Full Changelog: https://github.com/joshcirre/duo/compare/v0.1.4...v0.1.5

Full Changelog: https://github.com/joshcirre/duo/compare/v0.1.3...v0.1.4

Full Changelog: https://github.com/joshcirre/duo/compare/v0.1.2...v0.1.3

Full Changelog: https://github.com/joshcirre/duo/compare/v0.1.1...v0.1.2

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](https://github.com/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](https://github.com/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](https://github.com/joshcirre)/vite-plugin-duo

🚀 Quick Start

1. Add the Syncable trait to your models:

use JoshCirre\Duo\Syncable;

class Todo extends Model
{
    use Syncable;
}

2. Add the WithDuo trait to your Livewire/Volt components:

use JoshCirre\Duo\WithDuo;

new class extends Component {
    use WithDuo;
    // ...
}

3. Add [@duoMeta](https://github.com/duoMeta) to your layout:

<head>
    [@vite](https://github.com/vite)(['resources/css/app.css', 'resources/js/app.js'])
    [@duoMeta](https://github.com/duoMeta)
</head>

4. Configure Vite:

import duo from '[@joshcirre](https://github.com/joshcirre)/vite-plugin-duo';

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

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

📖 Documentation

• README
• Roadmap

🙏 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.