Welcome to the PowerSync documentation repository! Our docs are powered by Mintlify.
- Fork and clone your repository:
- On GitHub, click "Fork" at the top right of this repository to create your own copy.
- Then clone your fork:
git clone https://github.com/YOUR-USERNAME/powersync-docs.git cd powersync-docs - Install dependencies:
corepack enable pnpm install - Start the local docs server:
pnpm dev
The install command provides you with the Mintlify CLI. For a full list of commands, refer to the docs.
We welcome contributions! Please see CONTRIBUTING.md for details.
All changes merged to the main branch are automatically published to https://docs.powersync.com.
- Navigation and other global settings are defined in
docs.json. Learn more in Mintlify's docs. - If you move or rename a page, add a redirect using the
redirectsproperty to ensure existing links continue to work.
Regularly check for broken links by running:
pnpm check:links
To whitelist terms so Mintlify's Vale integration does not flag them as misspelled:
- Add terms (one per line, case-insensitive) to
.github/vale/config/vocabularies/PowerSync/accept.txt. - To blacklist terms, create a
reject.txtfile in the same folder. - For more info, see Mintlify's docs and Vale's docs.
FontAwesome icons are supported: https://fontawesome.com/search
We use the following icons for supported backend databases and SDKs:
- Postgres:
icon="elephant" - MongoDB:
icon="leaf" - MySQL:
icon="dolphin" - SQL Server:
icon="server" - Flutter:
icon="flutter" - React Native:
icon="react" - Web:
icon="js" - Kotlin:
icon="android" - Swift:
icon="swift" - Node.js:
icon="node-js" - .NET:
icon="microsoft" - Rust:
icon="rust"
- Mintlify dev isn't running: Run
pnpm installto re-install dependencies. - Page loads as a 404: Make sure you are running in a folder with
docs.json.