Get started
What is Tuttle?
Tuttle is an eXist-db application that adds version control to data collections in eXist-db.
It is part of and published by the e-editiones society and can be used by other eXist-db applications such as TEI Publisher to synchronize data collections between a Git repository and the database.
Tuttle wraps the APIs of the Git service providers under a single, common OpenAPI allowing projects to seemlessly add version control to their data.
Modes of operation
Tuttle offers 2 modes of operation:
- ‘Git2DB’
- ‘App2Git’
in the pictures below the Github Logo is used but Gitlab can be used the same way
Git to DB
In this scenario users use their own tools to edit documents and push their changes to a git repository.
With Tuttle enabled the configured eXist-db collection can be updated completely or incrementally on request or by using a git workflow for automatic deployment.
App to Git
An application may choose to use the Tuttle application to synchronize their database collections to a Git repository and allow users without Git knowledge to version their documents.
In this case the application will use the Tuttle API to offer a custom integration into its user interface.