diff --git a/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.14.11.png b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.14.11.png new file mode 100644 index 00000000..ed73ee5a Binary files /dev/null and b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.14.11.png differ diff --git a/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.32.31.png b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.32.31.png new file mode 100644 index 00000000..25d6dadc Binary files /dev/null and b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.32.31.png differ diff --git a/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.34.30.png b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.34.30.png new file mode 100644 index 00000000..774ea9e9 Binary files /dev/null and b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.34.30.png differ diff --git a/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.37.20.png b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.37.20.png new file mode 100644 index 00000000..eaa73755 Binary files /dev/null and b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.37.20.png differ diff --git a/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.38.37.png b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.38.37.png new file mode 100644 index 00000000..ea0df758 Binary files /dev/null and b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.38.37.png differ diff --git a/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.44.37.png b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.44.37.png new file mode 100644 index 00000000..fd154f7e Binary files /dev/null and b/apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.44.37.png differ diff --git a/google-setup.md b/google-setup.md new file mode 100644 index 00000000..70684ebb --- /dev/null +++ b/google-setup.md @@ -0,0 +1,138 @@ +# Connecting Google to Rowboat + +Rowboat requires a Google OAuth Client ID to connect to Gmail, Calendar, and Drive. Follow the steps below to generate your Client ID correctly. + +--- + +## 1️⃣ Open Google Cloud Console + +Go to: + +https://console.cloud.google.com/ + +Make sure you’re logged into the Google account you want to use. + +--- + +## 2️⃣ Create a New Project + +Go to: + +https://console.cloud.google.com/projectcreate + +- Click **Create Project** +- Give it a name (e.g. `Rowboat Integration`) +- Click **Create** + +Once created, make sure the new project is selected in the top project dropdown. + +![Select the new project in the dropdown](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.14.11.png) + +--- + +## 3️⃣ Enable Required APIs + +Enable the following APIs for your project: + +- Gmail API + + https://console.cloud.google.com/apis/api/gmail.googleapis.com + +- Google Calendar API + + https://console.cloud.google.com/apis/api/calendar-json.googleapis.com + +- Google Drive API + + https://console.cloud.google.com/apis/api/drive.googleapis.com + + +For each API: + +- Click **Enable** + + ![Enable the API](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.44.37.png) + + +--- + +## 4️⃣ Configure OAuth Consent Screen + +Go to: + +https://console.cloud.google.com/auth/branding + +### App Information + +- App name: (e.g. `Rowboat`) +- User support email: Your email + +### Audience + +- Choose **External** + +### Contact Information + +- Add your email address + +Click **Save and Continue** through the remaining steps. + +You do NOT need to publish the app — keeping it in **Testing** mode is fine. + +![OAuth consent screen](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.32.31.png) + +--- + +## 5️⃣ Add Test Users + +If your app is in Testing mode, you must add users manually. + +Go to: + +https://console.cloud.google.com/auth/audience + +Under **Test Users**: + +- Click **Add Users** +- Add the email address you plan to connect with Rowboat + +Save changes. + +![Add test users](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.34.30.png) + +--- + +## 6️⃣ Create OAuth Client ID + +Go to: + +https://console.cloud.google.com/auth/clients + +Click **Create Credentials → OAuth Client ID** + +### Application Type + +Select: + +**Universal Windows Platform (UWP)** + +- Name it anything (e.g. `Rowboat Desktop`) +- Store ID can be anything (e.g. `test` ) +- Click **Create** + +![Create OAuth Client ID (UWP)](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.37.20.png) + +--- + +## 7️⃣ Copy the Client ID + +After creation, Google will show: + +- **Client ID** +- **Client Secret** + +Copy the **Client ID** and paste it into Rowboat where prompted. + +![Copy Client ID](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.38.37.png) + +--- \ No newline at end of file