Expanding the Ecosystem: Connecting KnitBook to Ravelry
Expanding the Ecosystem: Connecting KnitBook to Ravelry
When we designed KnitBook, our primary goal was to create a reliable, local-first workspace where your data belongs to you. However, crafting does not happen in a vacuum. For millions of textile artists, Ravelry is the central repository for patterns, stash management, and community projects.
Today, we are sharing a look at how we are connecting KnitBook to Ravelry to bring the best of both worlds together: the speed and offline reliability of our Rust-backed architecture, combined with the vast database of the global fibre arts community.
Seamless Data Synchronisation
The upcoming integration will allow KnitBook to communicate directly with the Ravelry API. Instead of forcing you to manually migrate your data or manage two separate systems, KnitBook will act as a powerful, localised mirror of your Ravelry profile.
The integration will support bi-directional syncing across several core categories:
- Projects: Track your row counts, notes, and photos locally in KnitBook, and update them to your public Ravelry project pages when you are online.
- Yarn Stash: Access your digital yarn closet instantly. You can search your existing Ravelry stash within KnitBook to assign yarn to new local projects.
- Notions and Tools: Keep your needle inventory and notions synced so you always know what tools you have available, whether you are sitting at your desk or shopping at a local yarn store.
Technical Execution: Merging Local-First with External APIs
Integrating a third-party cloud API into a local-first application presents unique engineering challenges. Our core philosophy is that KnitBook must remain functional offline.
To achieve this, our Rust backend treats Ravelry as a synchronisation target rather than a primary data source.
When you make changes to your stash or projects while offline, KnitBook queues these operations locally. Once an internet connection is established, our sync engine resolves the differences using a Last-Writer-Wins (LWW) synchronisation strategy, ensuring that your localised updates safely merge with your Ravelry account without duplicating entries or overwriting newer data.
This approach ensures that you retain the core benefits of KnitBook—instant response times and total offline capability—while gaining access to the broader crafting ecosystem.
We are currently finalising the beta version of this integration and look forward to rolling it out to our users soon.