Skip to content

Commit 7ed7d62

Browse files
authored
Merge pull request #56 from powersync-ja/readme-monorepo
Monorepo updates to main README.md
2 parents 51d6b42 + 691476f commit 7ed7d62

File tree

1 file changed

+32
-20
lines changed

1 file changed

+32
-20
lines changed

README.md

Lines changed: 32 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,39 @@
1-
# PowerSync React Native SDK
1+
<p align="center">
2+
<a href="https://www.powersync.com" target="_blank"><img src="https://github.com/powersync-ja/.github/assets/19345049/602bafa0-41ce-4cee-a432-56848c278722"/></a>
3+
</p>
24

3-
Monorepo for all things React Native and PowerSync.
5+
PowerSync is a service and set of SDKs that keeps Postgres databases in sync with on-device SQLite databases.
46

5-
## Monorepo Structure
7+
# PowerSync JavaScript SDKs
68

7-
- [packages/powersync-sdk-common](./packages/powersync-sdk-common/README.md)
8-
- A TypeScript implementation of a PowerSync database connector and streaming sync bucket implementation.
9+
`powersync-js` is the monorepo for PowerSync JavaScript SDKs.
10+
11+
## Monorepo Structure: Packages
912

1013
- [packages/powersync-sdk-react-native](./packages/powersync-sdk-react-native/README.md)
11-
- An extension of `packages/powersync-sdk-common` which provides React Native specific implementations of abstracted features.
14+
- React Native SDK implementation (extension of `packages/powersync-sdk-common`)
15+
16+
- [packages/powersync-sdk-web](./packages/powersync-sdk-web/README.md)
17+
- JS Web SDK implementation (extension of `packages/powersync-sdk-common`)
18+
19+
- [packages/powersync-react](./packages/powersync-react/README.md)
20+
- React integration for PowerSync.
21+
22+
- [packages/powersync-attachments](./packages/powersync-attachments/README.md)
23+
- Attachments helper package for React Native.
24+
25+
- [packages/powersync-sdk-common](./packages/powersync-sdk-common/README.md)
26+
- Shared package: TypeScript implementation of a PowerSync database connector and streaming sync bucket implementation.
27+
28+
## Demo Apps / Example Projects
1229

13-
- [apps/supabase-todolist](https://github.com/powersync-ja/powersync-supabase-react-native-todolist-demo)
14-
- An Expo React Native demo app using Supabase.
30+
Demo applications are located in the [`demos/`](./demos/) directory.
31+
32+
- [demos/nextjs-supabase-todolist](./demos/nextjs-supabase-todolist/): A Next.js to-do list example app using the PowerSync Web SDK and a Supabase backend.
33+
- [demos/yjs-nextjs-supabase-text-collab](./demos/yjs-nextjs-supabase-text-collab/README.md): A Next.js real-time text editing collaboration example app powered by [Yjs]((https://github.com/yjs/yjs)) CRDTs and [Tiptap](https://tiptap.dev/), using the PowerSync Web SDK and a Supabase backend.
34+
- [demos/react-native-supabase-todolist](./demos/react-native-supabase-todolist) A React Native to-do list example app using a Supabase backend.
35+
- [demos/example-webpack](./demos/example-webpack/README.md) contains a minimal example demonstrating bundling with Webpack.
36+
- [demos/example-vite](./demos/example-vite/README.md) contains a minimal example demonstrating bundling with Vite.
1537

1638
# Development
1739

@@ -57,6 +79,8 @@ Merging a PR with Changesets will automatically create a PR with version bumps.
5779

5880
## React Native Quick SQLite Development
5981

82+
The PowerSync React Native SDK uses [a fork of react-native-quick-sqlite](https://github.com/powersync-ja/react-native-quick-sqlite)
83+
6084
Testing live development changes to `@journeyapps/react-native-quick-sqlite` will not work with standard `yarn link` commands. Metro does not work well with symlinks <https://github.com/facebook/metro/issues/286>.
6185

6286
The process of releasing development packages for `@journeyapps/react-native-quick-sqlite` for each change can be tedious and slow. A faster (and hackier) method is to use [mtsl](https://www.npmjs.com/package/mtsl) which will watch and copy the package into this workspace's `node_modules`.
@@ -72,15 +96,3 @@ mtsl add -s "[source path to your react-native-quick-sqlite repo folder]" -d "[t
7296
```bash
7397
mtsl start "[the id returned from step above]"
7498
```
75-
76-
## Testing Supabase example app
77-
78-
``` bash
79-
cd apps/supabase-todolist
80-
```
81-
82-
Test on either Android or iOS
83-
84-
```bash
85-
pnpm ios
86-
```

0 commit comments

Comments
 (0)