Orientação gerada a partir de informações públicas. Apenas para referência.
crdt_lf é uma implementação em Dart dos Tipos de Dados Replicáveis Livres de Conflito (CRDTs), projetada para aplicações com foco local. Permite colaboração em tempo real sem interrupções, garantindo consistência de dados entre múltiplos dispositivos sem necessidade de um servidor central. Ideal para editores de texto rico, Markdown e HTML, suporta edição offline e resolução automática de conflitos quando as conexões são restauradas. O pacote é independente de plataforma, funcionando em Android, iOS, Web, macOS, Windows e Linux.
Casos de uso
Edição colaborativa em tempo real de texto
Edição de documentos com foco em offline
Sincronização multi-dispositivo para aplicativos de texto rico
Gerenciamento de conteúdo descentralizado
Sincronizando documentos markdown entre dispositivos
Principais recursos
Sincronização de dados livre de conflitos
Suporta operação offline
Mesclagem automática de edições concorrentes
Leve e eficiente
Compatibilidade multiplataforma
Suporte interno para estruturas de texto rico
Indicado para
Ferramentas de escrita colaborativa
Aplicativos de anotações com capacidade offline
Editores de conteúdo distribuídos
Aplicativos que exigem sincronização em tempo real sem servidores
Desenvolvedores construindo aplicativos locais primeiro
Considerações
Requer conhecimento dos princípios de CRDT
Pode ter uso de memória mais alto com grandes conjuntos de dados
Não ideal para atualizações de alta frequência sem otimização
Documentação limitada além dos exemplos básicos
Mais adequado para texto estruturado do que para dados binários
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
A roadmap is available in the project page. The roadmap provides a high-level overview of the project's goals and the current status of the project.
Workspace structure
This repository is a workspace that contains multiple packages and apps.
Consistency is granted by the melos tool.
Melos
Melos (pub.dev)
is a CLI tool for Dart/Flutter monorepos. It links the local packages together,
so every package can depend on the others without publishing them first, and it
runs the same command over all of them (format, analyze, test, publish, ...).
Every shared command lives in melos.yaml and runs with
melos run <script>:
Script
What it does
format
formats the code (80 characters per line)
analyze
runs the analyzer with warnings and infos as errors
test / test_flutter / test_chrome
runs the Dart, Flutter and web tests
benchmark
runs the benchmarks of every package with a benchmarks/ folder
devtools_build
builds the DevTools extension
docs_bs / docs_build
bootstraps and builds the documentation site
update_references
propagates package/app references into the READMEs
Setup
The Flutter SDK is pinned with fvm, and the documentation
site is a Docusaurus project, so Node.js (with
npm) is required too.
fvm install # installs the pinned Flutter SDK
fvm dart pub get # resolves the workspace tools (melos included)
fvm dart run melos bootstrap # links the packages and prepares the examples
fvm dart run melos run docs_bs # optional: installs the documentation site (needs Node.js)
Note
Melos is a dev_dependency of the root pubspec.yaml, so
running it as fvm dart run melos ... is the safest option: you use the melos
version pinned by this repository, with the Flutter/Dart SDK pinned by fvm.
A globally activated melos (dart pub global activate melos) works as well,
but it may be a different version than the one the workspace expects, and the
difference usually shows up at the worst possible moment 🙃.
A command is provided to try to publish all packages:
fvm dart run melos publish --dry-run
This ensures that every package is formatted, analyzed, tested and built.
Organization
The repository structure is organized as follows:
workspace/├──melos.yaml# melos configuration file├──packages/# contains every package of the workspace│├──core/# the CRDT engine and its bindings││├──crdt_lf/│││├──lib/│││├──example/│││└──flutter_example/││└──.../│├──adapters/││└──persistence/# storage backends for crdt_lf││├──crdt_lf_drift/││├──crdt_lf_hive/││└──crdt_lf_sqlite/│└──_internal/# private, unpublished packages│├──benchmark_infrastructure/│└──shared_examples_infrastructure/├──apps/# contains the applications built on top of the packages│└──greyhound_markdown/│├──client/│└──server/├──docs/# the documentation site (Docusaurus, Node.js project)├──scripts/# dart scripts used by the melos commands└──assets/# contains the assets used in the documentation└──.../
VS Code
If you work with VS Code, the repository already contains a
.vscode folder with:
the recommended extensions (Dart, Flutter, Melos, Mermaid);
the settings (fvm SDK path, project dictionary for the spell checker);
the launch configurations for the apps and the examples;
the snippets used in the READMEs and the changelogs.
Accepting the recommended extensions gives you the smoothest experience on this
workspace.
Contributing
Contributions are welcome: bug fixes, new features, documentation, performance
work, or anything else — a fixed typo counts too 💚.
The whole flow (roadmap, issues, pull requests, AI-assisted work) is described
in CONTRIBUTING.md. Please read it before opening an issue
or a pull request.