base on Make your JSON data collaborative and version-controlled with CRDTs <p align="center"> <a href="https://loro.dev"> <picture> <img src="./docs/Loro.svg" width="200"/> </picture> </a> </p> <h1 align="center"> <a href="https://loro.dev" alt="loro-site">Loro</a> </h1> <p align="center"> <b>Make your JSON data collaborative and version-controlled 🦜</b> </p> <p align="center"> <a href="https://trendshift.io/repositories/4964" target="_blank"><img src="https://trendshift.io/api/badge/repositories/4964" alt="loro-dev%2Floro | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </p> <p align="center"> <a href="https://loro.dev/docs"> <b>Documentation</b> </a> | <a href="https://loro.dev/docs/tutorial/get_started"> <b>Getting Started</b> </a> | <a href="https://docs.rs/loro"> <b>Rust Doc</b> </a> </p> <p align="center"> <a aria-label="X" href="https://x.com/loro_dev" target="_blank"> <img alt="" src="https://img.shields.io/badge/Twitter-black?style=for-the-badge&logo=Twitter"> </a> <a aria-label="Discord-Link" href="https://discord.gg/tUsBSVfqzf" target="_blank"> <img alt="" src="https://img.shields.io/badge/Discord-black?style=for-the-badge&logo=discord"> </a> <a aria-label="Gurubase" href="https://gurubase.io/g/loro" target="_blank"> <img alt="" src="https://img.shields.io/badge/Ask%20Loro%20Guru-000000?style=for-the-badge"> </a> </p> https://github.com/loro-dev/loro/assets/18425020/fe246c47-a120-44b3-91d4-1e7232a5b4ac <h4 align="center"> ✨ Loro 1.0 is out! Read the <a href="https://loro.dev/blog/v1.0">announcement</a>. </h4> Loro is a [CRDTs(Conflict-free Replicated Data Types)](https://crdt.tech/) library that makes building [local-first][local-first] and collaborative apps easier. You can now use it in Rust, JS (via WASM), and Swift. # Features **Features Provided by CRDTs** - P2P Synchronization - Automatic Merging - Local Availability - Scalability - Delta Updates **Supported CRDT Algorithms** - 📝 Text Editing with [Fugue] - 📙 [Rich Text CRDT](https://loro.dev/blog/loro-richtext) - 🌲 [Moveable Tree](https://loro.dev/docs/tutorial/tree) - 🚗 [Moveable List](https://loro.dev/docs/tutorial/list) - 🗺️ [Last-Write-Wins Map](https://loro.dev/docs/tutorial/map) **Advanced Features in Loro** - 🚀 [Fast Document Loading](https://loro.dev/blog/v1.0) - ⏱️ Fast [Time Travel](https://loro.dev/docs/tutorial/time_travel) Through History - 🏛️ [Version Control with Real-Time Collaboration](https://loro.dev/blog/v1.0#version-control) - 📦 [Shallow Snapshot](https://loro.dev/docs/advanced/shallow_snapshot) that Works like Git Shallow Clone https://github.com/user-attachments/assets/68e0017a-4987-4f71-b2cf-4ed28a210987 > In this example, we demonstrate importing an entire Loro codebase into a Loro-powered > version controller, preserving the complete Git DAG history while enabling fast version switching. # Example [](https://stackblitz.com/edit/loro-basic-test?file=test%2Floro-sync.test.ts) ```ts import { expect, test } from "vitest"; import { LoroDoc, LoroList } from "loro-crdt"; test("sync example", () => { // Sync two docs with two rounds of exchanges // Initialize document A const docA = new LoroDoc(); const listA: LoroList = docA.getList("list"); listA.insert(0, "A"); listA.insert(1, "B"); listA.insert(2, "C"); // Export all updates from docA const bytes: Uint8Array = docA.export({ mode: "update" }); // Simulate sending `bytes` across the network to another peer, B const docB = new LoroDoc(); // Peer B imports the updates from A docB.import(bytes); // B's state matches A's state expect(docB.toJSON()).toStrictEqual({ list: ["A", "B", "C"], }); // Get the current version of docB const version = docB.oplogVersion(); // Simulate editing at B: delete item 'B' const listB: LoroList = docB.getList("list"); listB.delete(1, 1); // Export the updates from B since the last sync point const bytesB: Uint8Array = docB.export({ mode: "update", from: version }); // Simulate sending `bytesB` back across the network to A // A imports the updates from B docA.import(bytesB); // A has the same state as B expect(docA.toJSON()).toStrictEqual({ list: ["A", "C"], }); }); ``` # DevTools ## Loro Inspector You can use the [Loro Inspector](https://inspector.loro.dev) to inspect the state and history of a Loro document. https://github.com/user-attachments/assets/ceeb7450-80ce-42f2-aef4-2e08fa2d1f1b # Bindings You can find bindings for other programming languages in [loro-ffi](https://github.com/loro-dev/loro-ffi). # Blog - [Loro 1.0](https://loro.dev/blog/v1.0) - [Movable tree CRDTs and Loro's implementation](https://loro.dev/blog/movable-tree) - [Introduction to Loro's Rich Text CRDT](https://loro.dev/blog/loro-richtext) - [Loro: Reimagine State Management with CRDTs](https://loro.dev/blog/loro-now-open-source) # Sponsors [](https://github.com/sponsors/loro-dev) # Credits Loro draws inspiration from the innovative work of the following projects and individuals: - [Diamond-types](https://github.com/josephg/diamond-types): The [Event Graph Walker (Eg-walker)](https://loro.dev/docs/advanced/event_graph_walker) algorithm from @josephg has been adapted to reduce the computation and space usage of CRDTs. - [Automerge](https://github.com/automerge/automerge): Their use of columnar encoding for CRDTs has informed our strategies for efficient data encoding. - [Yjs](https://github.com/yjs/yjs): We have incorporated a similar algorithm for effectively merging collaborative editing operations, thanks to their pioneering work. - [Matthew Weidner](https://mattweidner.com/): His work on the [Fugue](https://arxiv.org/abs/2305.00583) algorithm has been invaluable, enhancing our text editing capabilities. - [Martin Kleppmann](https://martin.kleppmann.com/): His work on CRDTs has significantly influenced our comprehension of the field. [local-first]: https://www.inkandswitch.com/local-first/ [Fugue]: https://arxiv.org/abs/2305.00583 ", Assign "at most 3 tags" to the expected json: {"id":"4964","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"