Daystead setup

New here?

Setup takes about 10 minutes, once. You'll make a free Supabase account, copy a few values into this page, and it installs everything for you. No coding and no Terminal. (Want the Gmail sections too? The advanced Google option adds about 10 minutes in Google Cloud.)

You'll need your licence key from your purchase email, and a computer (setup is fiddly on a phone). Your data is stored in your own Supabase project, never on this site. Each licence key sets up one board, which you can use on all your own devices.

Already set up on another device?

On the device that's already set up, open Settings → Your devices. Scan the code with this device's camera, or copy the link here:

Your licence key

It's in your purchase email from Gumroad or Lemon Squeezy (and in your Gumroad library, or your Lemon Squeezy "My Orders" page).

One key, one board. The first install links your key to the Supabase project you choose. After that, the same key updates or repairs that board (and sets up its Garmin sync), but it can't set up a second board. Use your board on as many of your own devices as you like.

Your database (Supabase)

free, no card

Open supabase.com and make a free account (signing in with GitHub or email is fine).
Press New project. Name it daystead, press Generate a password (you won't need it again), pick the region nearest you, and press Create new project.
Wait a minute or two until it says the project is ready.

Your project's address

Copy it from your browser's address bar while you're in the project (it contains /project/), or from Project Settings → Data API → Project URL.

A setup access token

Open Account → Access Tokens and press Generate new token.
Name: Daystead setup. Expires in: the shortest option (24 hours is fine).
Resource access: keep Project ticked. In Select an organization pick your organization, then in the box below it pick your daystead project.
Permissions: leave it on Preset · Full access. Don't change anything in the lists underneath. The setup needs to create tables, turn on Google sign-in and install the server, and the token can only touch the one project you picked.
Press Review access, then Generate token. Copy the token straight away: Supabase only shows it once. It usually starts with sbp_.

Show me this screen

Supabase's Generate token screen with each field numbered: 1 name, 2 expiry, 3 keep Project, 4 your organization, 5 your daystead project, 6 leave Full access, 7 Review access then Generate — Fill it in following the numbered boxes. Tap the picture to see it bigger.

The token lets this page install the board into your project. It's used only while this page is open: never saved, here or on our server. You can delete it as soon as setup is finished.

Check it's the right project: installing links your licence key to it for good.

Google sign-in and Calendar

free, no card

Which Google account will you sign in to your board with?

Only this account can open your board. Its calendar is the one your board shows.

How should your board connect to Google? Quick: Daystead's Google connection Nothing to set up here: you just sign in to your board with Google. Covers Calendar and Google Tasks. Your calendar and tasks go straight between Google and your own board, never through our site. Advanced: your own Google client About 10 minutes in Google Cloud. Also adds the email sections (Orders & deliveries and uni emails), which read Gmail.

While Google finishes reviewing Daystead, the first sign-in shows "Google hasn't verified this app". That's expected: press Advanced, then Go to Daystead.

Your own Google client lets you sign in with Google and lets your board read your calendar and email. It's the longest step: about 10 minutes. Keep this page open in one tab and Google Cloud in another. Use the account above all the way through: to create the Google Cloud project, as the test user, and to sign in to your board.

Open the Google Cloud console and make a new project called Daystead. When it's made, check Daystead is the project selected at the top of the page. Every step below happens inside it.
Turn on these, pressing Enable on each (open each link, check the project at the top says Daystead, then press Enable): Google Calendar API, Gmail API (for deliveries and uni emails) and Google Tasks API (for the Tasks sync).
Open Google Auth Platform and press Get started. App name: Daystead. Support and contact email: yours. Audience: External. Agree and Create. Work or school account (not @gmail.com)? You can pick Internal instead: no weekly reconnect and no test users needed.
Don't skip this one. Open Audience. Leave it in Testing. Scroll to Test users, press Add users, paste this address and press Save:
(type your Google address at the top first)
Check it now appears in the Test users list. Without it, Google blocks your sign-in with "Access blocked … Error 403: access_denied".
Open Data access → Add or remove scopes. Scroll to Manually add scopes, paste the box below, press Add to table, then Update. Then scroll to the bottom of the page and press Save (easy to miss).
https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/tasks
Open Clients → Create client. Type: Web application. Name: Daystead. Scroll past Authorised JavaScript origins (leave it empty) to Authorised redirect URIs, press Add URI and paste:
https://…supabase.co/auth/v1/callback
Press Create. Copy the Client ID and Client secret into the boxes below straight away: Google only shows the secret once. (Lost it? Open the client, press Add secret and use the new one.)

"Testing" means Google never needs to review your app, because only you use it. The catch: about once a week, Google asks you to sign in again. The board shows a Reconnect Google button for it.

Make it yours

you can change all of this later in Settings

Your board is ready

Delete the setup token: open Access Tokens and delete Daystead setup. You'll make a new one if you ever update.
Open your board and press Sign in with Google. If Google warns that the app isn't verified, press Advanced (or Continue), then Go to Daystead, and tick every box it offers.
On your phone: open the device link from Settings → Your devices, then use the browser's Install app or Add to Home Screen.

Trouble signing in?

"Access blocked … has not completed the Google verification process" (Error 403: access_denied): Your Google account isn't a test user yet. In Google Cloud open Audience (with the Daystead project selected), press Add users under Test users, add the exact address you're signing in with, press Save, then sign in again.
"Google hasn't verified this app": That's expected while Google reviews Daystead, or for your own private app. Press Continue (or Advanced, then Go to …) and tick every box.
"Error 400: redirect_uri_mismatch": Open Clients → Daystead and check Authorised redirect URIs holds exactly your Supabase address + /auth/v1/callback, with nothing extra. Save, wait a minute, then try again.
"That Google account isn't the owner of this board": You signed in with a different account from the one you typed during setup. Sign in with that one.
"Google needs all the boxes ticked": Press Reconnect Google on your board and tick every box this time.

Open my board