Skip to content

Add Kotlin Encryption details; add missing Tanstack DB alpha ref #311

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
benitav wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Add Kotlin Encryption details; add missing Tanstack DB alpha ref #311

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
80240d3
Add Kotlin Encryption details; add missing Tanstack DB alpha ref
benitav Dec 12, 2025
5a55bb6
wording
benitav Dec 12, 2025
ba540a1
Update usage/use-case-examples/data-encryption.mdx
benitav Dec 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions client-sdk-references/javascript-web/javascript-spa-frameworks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,11 +89,15 @@

### TanStack DB

[TanStack DB](https://tanstack.com/db/latest/docs/collections/powersync-collection) is a reactive client store that provides blazing-fast in-memory queries, optimistic updates, and cross-collection queries. When combined with PowerSync, you get the best of both worlds: TanStack DB's powerful query capabilities with PowerSync's battle-tested offline-first and multi-tab capable sync engine.

Check warning on line 92 in client-sdk-references/javascript-web/javascript-spa-frameworks.mdx

View check run for this annotation

Mintlify / Mintlify Validation (powersync) - vale-spellcheck

client-sdk-references/javascript-web/javascript-spa-frameworks.mdx#L92 

Did you really mean 'DB's'?

<Note>
The PowerSync TanStack DB collection is currently in an [Alpha](/resources/feature-status) release.
</Note>

**TanStack DB Features:**

* **Blazing Fast In-Memory Queries**: Built on differential data flow, TanStack DB's live queries update incrementally (rather than re-running entire queries), making queries incredibly fast, even for complex queries across multiple collections.

Check warning on line 100 in client-sdk-references/javascript-web/javascript-spa-frameworks.mdx

View check run for this annotation

Mintlify / Mintlify Validation (powersync) - vale-spellcheck

client-sdk-references/javascript-web/javascript-spa-frameworks.mdx#L100 

Did you really mean 'DB's'?

* **Reactive Data Flow**: Live queries automatically update when underlying data changes, triggering component re-renders only when necessary.

Expand Down
4 changes: 4 additions & 0 deletions client-sdk-references/kotlin/encryption.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: Encryption
url: /usage/use-case-examples/data-encryption
---
3 changes: 2 additions & 1 deletion docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -340,7 +340,8 @@
"client-sdk-references/kotlin/libraries/room"
]
},
"client-sdk-references/kotlin/usage-examples"
"client-sdk-references/kotlin/usage-examples",
"client-sdk-references/kotlin/encryption"
]
},
{
Expand Down
2 changes: 2 additions & 0 deletions resources/feature-status.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@ Below is a summary of the current main PowerSync features and their release stat
| Flutter Web Support | Beta |
| React Native Web Support | Beta |
| Flutter SQLCipher | Beta |
| Kotlin SQLite3MultipleCiphers | Beta |
| Vue Composables | Beta |
| React Hooks | V1 |
| | |
Expand All @@ -77,6 +78,7 @@ Below is a summary of the current main PowerSync features and their release stat
| Drift (Flutter) | Beta |
| Drizzle (JS) | Beta |
| Kysely (JS) | Beta |
| TanStack DB (JS) | Alpha |
| SQLDelight (Kotlin) | Beta |
| | |
| **Attachment Helpers** | |
Expand Down
6 changes: 6 additions & 0 deletions usage/use-case-examples/data-encryption.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,12 @@ The client-side database can be encrypted at rest. This is currently available f
Encryption support is available for PowerSync's Node.js SDK using [`better-sqlite3-multiple-ciphers`](https://www.npmjs.com/package/better-sqlite3-multiple-ciphers). See usage details and code examples in the [Node.js SDK reference](/client-sdk-references/node#encryption-and-custom-sqlite-drivers).
</Accordion>

<Accordion title="Kotlin" icon="k">
Encryption support is available for PowerSync's Kotlin SDK using [`SQLite3MultipleCiphers`](https://utelle.github.io/SQLite3MultipleCiphers/). This allows you to encrypt your local SQLite database with various cipher algorithms.

For implementation details see [`sqlite3multipleciphers`](https://github.com/powersync-ja/powersync-kotlin/tree/main/sqlite3multipleciphers) in the PowerSync Kotlin SDK.
Copy link
Contributor

@simolus3 simolus3 Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't sound particularly inviting :D Should I add a few snippets here for the different platforms?

Copy link
Collaborator Author

@benitav benitav Dec 12, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes sure :) Currently encryption details are documented in different places for all SDKs... if you can think of a quick win here pls feel free. But I will also add that this kind of thing is something we'll address with the new docs structure: https://journeyapps.slack.com/archives/C043VUKN35K/p1764915929298199 (perhaps not in the first phase but the idea is to get there).

</Accordion>

<Note>
Support for encryption on other platforms is planned. In the meantime, let us know your needs and use cases on [Discord](https://discord.gg/powersync).
</Note>
Expand Down