From c182999b56d439f6af86c0c1f5f2f67bc7e2e863 Mon Sep 17 00:00:00 2001 From: dean-journeyapps Date: Mon, 2 Jun 2025 11:44:24 +0200 Subject: [PATCH 1/6] Updated .NET demo app examples to include new WPF To-Do List demo and CLI App Supabase connector. Added .NET demo backend project. Also fixed double bullet point in Swift To-Do List. --- resources/demo-apps-example-projects.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/resources/demo-apps-example-projects.mdx b/resources/demo-apps-example-projects.mdx index 9c107d0..8097c99 100644 --- a/resources/demo-apps-example-projects.mdx +++ b/resources/demo-apps-example-projects.mdx @@ -99,13 +99,15 @@ This page showcases example projects organized by platform and backend technolog #### Supabase Backend * [To-Do List App](https://github.com/powersync-ja/powersync-swift/tree/main/Demo) - * * Demonstrates [File/Attachment Handling](/usage/use-case-examples/attachments-files) + * Demonstrates [File/Attachment Handling](/usage/use-case-examples/attachments-files) #### Examples * [CLI Application](https://github.com/powersync-ja/powersync-dotnet/tree/main/demos/CommandLine) + * Includes an optional [Supabase connector](https://github.com/powersync-ja/powersync-dotnet/blob/main/demos/CommandLine/SupabaseConnector.cs) + * [WPF To-Do list App](https://github.com/powersync-ja/powersync-dotnet/tree/main/demos/WPF) @@ -126,6 +128,10 @@ This page showcases example projects organized by platform and backend technolog * [Rails Backend for GoToFun App](https://github.com/powersync-ja/powersync-rails-flutter-demo/tree/main/gotofun-backend) * For use with: Flutter [GoToFun App](https://github.com/powersync-ja/powersync-rails-flutter-demo/tree/main/gotofun-app) + + #### .NET + + * [.NET Backend for To-Do List App](https://github.com/powersync-ja/powersync-dotnet-backend-demo) From b79622fe6db8856cdfd6eec13cb70a9e3bfa2e48 Mon Sep 17 00:00:00 2001 From: dean-journeyapps Date: Wed, 11 Jun 2025 15:03:12 +0200 Subject: [PATCH 2/6] Updated .Net to include all demo projects --- client-sdk-references/dotnet.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/client-sdk-references/dotnet.mdx b/client-sdk-references/dotnet.mdx index 2e89d61..6e25ca9 100644 --- a/client-sdk-references/dotnet.mdx +++ b/client-sdk-references/dotnet.mdx @@ -19,9 +19,9 @@ import DotNetInstallation from '/snippets/dotnet/installation.mdx'; A full API Reference for this SDK is not yet available. This is planned for a future release. - - A small CLI app showcasing bidirectional sync. - + + Gallery of example projects/demo apps built with .NET and PowerSync. + From 55dc51d7f44afad620914151dada0ec155923477 Mon Sep 17 00:00:00 2001 From: dean-journeyapps Date: Wed, 11 Jun 2025 15:05:11 +0200 Subject: [PATCH 3/6] Added .complete() note to writing-client-changes recommendations --- installation/app-backend-setup/writing-client-changes.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/installation/app-backend-setup/writing-client-changes.mdx b/installation/app-backend-setup/writing-client-changes.mdx index 9e6baba..d798056 100644 --- a/installation/app-backend-setup/writing-client-changes.mdx +++ b/installation/app-backend-setup/writing-client-changes.mdx @@ -49,6 +49,10 @@ We do however recommend the following: 1. Including the error details in the `2xx` response. 2. Writing the error(s) into a separate table/collection that is synced to the client, so that the client/user can handle the error(s). + +If you don't call `.complete()` on an operation, it will remain in the queue and continue to be retried. This may be intentional to maintain consistency with your remote database, but be aware that incomplete operations will prevent the queue from progressing past that point. + + For details on approaches, see: From db2ef5fa462fe94255f8e56e6f30193ed33cbedc Mon Sep 17 00:00:00 2001 From: dean-journeyapps Date: Wed, 11 Jun 2025 15:06:58 +0200 Subject: [PATCH 4/6] Added comment to JWKS_URL indicating its not applicable for Supabase --- tutorials/self-host/generate-dev-token.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/self-host/generate-dev-token.mdx b/tutorials/self-host/generate-dev-token.mdx index ce0b5a1..005085c 100644 --- a/tutorials/self-host/generate-dev-token.mdx +++ b/tutorials/self-host/generate-dev-token.mdx @@ -41,7 +41,7 @@ Development tokens can be generated via either # Client (application end user) authentication settings client_auth: # JWKS URIs can be specified here - jwks_uri: !env PS_JWKS_URL + jwks_uri: !env PS_JWKS_URL # Not applicable for Supabase jwks: keys: - kty: 'oct' From e9d48a297272f33dfd52176b4260de9c352a1e34 Mon Sep 17 00:00:00 2001 From: dean-journeyapps Date: Wed, 11 Jun 2025 15:07:48 +0200 Subject: [PATCH 5/6] Added link on "JOINS" to redirect to parameter query restrictions --- usage/sync-rules/guide-many-to-many-and-join-tables.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/usage/sync-rules/guide-many-to-many-and-join-tables.mdx b/usage/sync-rules/guide-many-to-many-and-join-tables.mdx index 869b98c..b31174a 100644 --- a/usage/sync-rules/guide-many-to-many-and-join-tables.mdx +++ b/usage/sync-rules/guide-many-to-many-and-join-tables.mdx @@ -106,7 +106,7 @@ JOIN posts ON posts.id = comments.post_id WHERE board_id = bucket.board_id ``` -Unfortunately, joins are not supported in PowerSync's Sync Rules. Instead, we denormalize the data to add a direct foreign key relationship between comments and boards: (Postgres example) +Unfortunately, [JOINS](/usage/sync-rules/parameter-queries#restrictions) are not supported in PowerSync's Sync Rules. Instead, we denormalize the data to add a direct foreign key relationship between comments and boards: (Postgres example) ```sql ALTER TABLE comments ADD COLUMN board_id uuid; From 85eede997d2ac06a92640855e52cc487fa156a1b Mon Sep 17 00:00:00 2001 From: dean-journeyapps Date: Thu, 12 Jun 2025 10:12:51 +0200 Subject: [PATCH 6/6] Added jwks_uri not applicable when using Supabase --- self-hosting/installation/powersync-service-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/self-hosting/installation/powersync-service-setup.mdx b/self-hosting/installation/powersync-service-setup.mdx index 74b0c39..8306f27 100644 --- a/self-hosting/installation/powersync-service-setup.mdx +++ b/self-hosting/installation/powersync-service-setup.mdx @@ -160,7 +160,7 @@ client_auth: # supabase_jwt_secret: your-secret # JWKS URIs can be specified here. - jwks_uri: http://demo-backend:6060/api/auth/keys + jwks_uri: http://demo-backend:6060/api/auth/keys # Not applicable for Supabase # JWKS audience audience: ['powersync-dev', 'powersync']