‼️ Note: Zero native not working yet

There's a recent bug with top-level await happening that we are looking into fixing.

Install packages with yarn:

yarn

For login, we have set up Github auth with Better Auth as an example.

1. Create a new Github App
2. Copy .env.example to .env
3. Fill in GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET

in three separate tabs:

yarn docker up
yarn zero
yarn dev

to run tauri you can run this instead of yarn dev:

yarn dev:tauri

to reset all your data:

yarn docker:start:clean

Getting Tauri to handle auth in a sane way takes a bit of work, but we've set up most of it here for you. If you're using OAuth, you don't want to force your users to login via the Tauri window, as they will lack all saved credentials and be forced to memorize their password / not use passkeys, etc.

So instead we open the login link using target="_blank" so it opens in their default browser, making for a smooth login experience. But that means you need to pass back the credentials to Tauri once logged in.

To do this, we added the deep-link plugin to Tuari, allowing for one-zero://domain style URLs to open with your native Tuari app. This allows for really nice hand-off.

On Mac though, you can't use deep links in dev mode. So you'll need to make a production build, drag it to your Applications folder, and run your app from there. We set up the production build to hit your same development server for now, so you can actually just use that built app as your main dev driver. It includes dev tools as you'd normally want, too. Once you set this up development is easy, and login has great UX.

This project includes VS Code launch configurations for easy development. To use them:

1. Open the Run and Debug sidebar (Ctrl+Shift+D or Cmd+Shift+D)
2. Select one of the following from the dropdown:
   • "Launch Web App (All Services)" - Runs all services for web development
   • "Launch Tauri App (All Services)" - Runs all services for Tauri development
3. Click the play button or press F5 to start

Individual services can also be launched separately from the same dropdown menu.