Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yorkie-team/yorkie
Yorkie is a document store for collaborative applications.
https://github.com/yorkie-team/yorkie
collaborative-applications crdt go grpc hacktoberfest realtime-collaboration yorkie
Last synced: 5 days ago
JSON representation
Yorkie is a document store for collaborative applications.
- Host: GitHub
- URL: https://github.com/yorkie-team/yorkie
- Owner: yorkie-team
- License: apache-2.0
- Created: 2018-10-24T23:44:47.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T08:31:29.000Z (7 months ago)
- Last Synced: 2024-04-14T09:58:46.693Z (7 months ago)
- Topics: collaborative-applications, crdt, go, grpc, hacktoberfest, realtime-collaboration, yorkie
- Language: Go
- Homepage: https://yorkie.dev
- Size: 27.4 MB
- Stars: 705
- Watchers: 15
- Forks: 125
- Open Issues: 70
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
- awesome-list - yorkie - team | 261 | (Go)
README
# Yorkie
[![GitHub](https://img.shields.io/github/stars/yorkie-team/yorkie.svg?style=social)](https://github.com/yorkie-team/yorkie)
[![Twitter](https://img.shields.io/twitter/follow/team_yorkie.svg?label=Follow)](https://twitter.com/team_yorkie)
[![Discord](https://img.shields.io/discord/928301813785038878?label=discord&logo=discord&logoColor=white)](https://discord.gg/MVEAwz9sBy)
[![Contributors](https://img.shields.io/github/contributors/yorkie-team/yorkie.svg)](https://github.com/yorkie-team/yorkie/contributors)
[![Commits](https://img.shields.io/github/commit-activity/m/yorkie-team/yorkie.svg)](https://github.com/yorkie-team/yorkie/pulse)[![Build Status](https://github.com/yorkie-team/yorkie/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/yorkie-team/yorkie/actions/workflows/ci.yml)
[![Go Report Card](https://goreportcard.com/badge/github.com/yorkie-team/yorkie)](https://goreportcard.com/report/github.com/yorkie-team/yorkie)
[![CodeCov](https://img.shields.io/codecov/c/github/yorkie-team/yorkie)](https://codecov.io/gh/yorkie-team/yorkie)
[![Godoc](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)](https://godoc.org/github.com/yorkie-team/yorkie)Yorkie is an open-source document store for building real-time collaborative applications. It uses JSON-like documents(CRDT) with optional types.
Yorkie consists of three main components: Client, Document and Server.
```
Client "A" (Go) Server(Cloud or Self-Hosted) MongoDB or MemDB
┌───────────────────┐ ┌────────────────────────┐ ┌───────────┐
│ Document "D-1" │◄─Changes─►│ Project "P-1" │ │ Changes │
│ { a: 1, b: {} } │ │ ┌───────────────────┐ │◄─►│ Snapshots │
└───────────────────┘ │ │ Document "D-1" │ │ └───────────┘
Client "B" (JS) │ │ { a: 2, b: {} } │ │
┌───────────────────┐ │ │ │ │
│ Document "D-1" │◄─Changes─►│ │ Document "D-2" │ │
│ { a: 2, b: {} } │ │ │ { a: 3, b: {} } │ │
└───────────────────┘ │ └───────────────────┘ │
Dashboard or CLI └────────────────────────┘
┌────────────────────┐ ▲
│ Query "Q-1" │ |
│ P-1.find({a:2}) ├───── Query───┘
└────────────────────┘
```Key Features:
- Clients: Clients can have a local replica of the document representing an application model on several devices.
- Offline Editing: Each client can independently update the document on their local device, even while offline.
- Synchronization: When a network connection is available, the client figures out which changes need to be synced from one device to another, and brings them into the same state.
- Conflict Resolution: If the document was changed concurrently on different devices, Yorkie automatically syncs the changes, so that every replica ends up in the same state with resolving conflicts.
- Database Integration: Yorkie supports MongoDB and MemDB as the underlying data storage.## Documentation
Full, comprehensive [documentation](https://yorkie.dev/docs) is available on the Yorkie website.
### Getting Started
- [with JS SDK](https://yorkie.dev/docs/getting-started/with-js-sdk)
- [with iOS SDK](https://yorkie.dev/docs/getting-started/with-ios-sdk)
- [with Android SDK](https://yorkie.dev/docs/getting-started/with-android-sdk)## Contributing
See [CONTRIBUTING](CONTRIBUTING.md) for details on submitting patches and the contribution workflow.
## Contributors ✨
Thanks go to these incredible people:
## Sponsors
Is your company using Yorkie? Ask your boss to support us. It will help us dedicate more time to maintain this project and to make it even better for all our users. Also, your company logo will show up on here and on our website: -) [[Become a sponsor](https://opencollective.com/yorkie#sponsor)]
### Backers
Please be our [Backers](https://opencollective.com/yorkie#backers).