🍬 Stupid Simple

A stupidly simple, candy-colored desktop calendar for Windows with two-way Google Calendar sync, a birthday module that reminds you a week ahead, time blocking, and desktop notifications. Jelly-bean events, springy animations, bubblegum/mango/mint/berry palette.

Built with Tauri 2 + React + TypeScript — the whole app is a few small files.

Features

• 🔄 Two-way Google Calendar sync — anything you add/change/delete in Stupid Simple lands in Google instantly; changes from Google (your phone, the browser) come back automatically every minute
• 🎂 Birthdays — type a name + day and month; you get a yearly event with a reminder 7 days ahead and on the day itself; the sidebar counts down to upcoming birthdays
• 🧱 Time blocking — drag across the hour grid in day/week view to block time; drag across days in month view to create multi-day events
• 🔔 Desktop notifications — 10 minutes before and at event start, plus a separate one when someone has a birthday today
• ✅ Daily tasks — a checklist per day in the sidebar: add, check off, edit inline, delete; the month view shows a done/total badge on each day (stored locally, not synced)
• 📥 Backlog — undated someday-tasks; the 📅 button on any task moves it to today, tomorrow, a picked date, or back to the backlog
• 🗃 Tasks board — a dedicated tab (press B) with Backlog, Overdue, Today, Tomorrow and Upcoming columns; overdue days offer a one-click "move all to today"; the sidebar is resizable by dragging its edge
• ✨ AI quick-add — type "gym tomorrow 18:00" and AI files it as an event or task; works with a free Gemini API key from aistudio.google.com/apikey (paste it in Settings)
• 🗂 Sidebar sections collapse and remember their state
• ⚙️ Settings — default view, 12/24-hour clock, dark mode, and five accent colors
• 📅 Day / week / month views, a "now" line, candy colors, event editing and deleting, optimistic saves with rollback on error; click a day number in month view to jump to that day
• 🔍 Event details at a glance — descriptions show up right on the calendar (inline in month view, under the title in week/day view, full text on hover); click any event for a details card with the complete description, then edit or delete from there

Keyboard shortcuts

Key	Action
← / →	previous / next day, week or month
T	jump to today
D / W / M / B	day / week / month / tasks-board view
N	new event
+ / - (or Ctrl+scroll)	zoom the hour grid in week/day view
Esc	close dialog

Install on Android 📱

Stupid Simple also builds as an Android app (same codebase, Tauri 2).

1. Grab the latest .apk from Releases (the arm64/universal one for a normal phone).
2. Copy it to your phone and open it — Android will ask to allow installing from this source; accept.
3. Open the app, tap Connect Google Calendar, sign in. The sidebar lives behind the ☰ button; day view is the default on phones.

The phone build is signed with the project's release key, so updates install cleanly over each other.

Install (the easy way)

1. Go to Releases and download the latest .msi (or -setup.exe) installer.
2. Run it. That's the whole install.
3. Launch Stupid Simple, click Connect Google Calendar, sign in in the browser — done. Releases from v1.4.1 on ship with a built-in OAuth client, so there's nothing to configure.

While the app awaits Google's verification, the browser may show "Google hasn't verified this app" — click Advanced → Go to Stupid Simple (unsafe) to continue. Your data goes straight from your machine to Google; there's no server in between.

Google setup — only if you build from source with your own keys

1. Open https://console.cloud.google.com and create a new project (call it anything, e.g. "Stupid Simple").
2. APIs & Services → Library → search for Google Calendar API → Enable.
3. APIs & Services → OAuth consent screen:
   • User type: External → Create
   • Fill in the app name and your e-mail, skip the rest → Save
   • Under Test users add your own Gmail address (important — without this Google blocks sign-in with "app has not been verified")
4. APIs & Services → Credentials → Create Credentials → OAuth client ID:
   • Application type: Desktop app ⚠️ (not "Web application" — see troubleshooting below)
   • Any name → Create
   • Copy the Client ID and Client Secret
5. Paste both into the app on the first-launch screen → Save keys → Connect Google Calendar → your browser opens → sign in and approve. Done — the keys are remembered.

Troubleshooting

Error 400: redirect_uri_mismatch

Google shows this in the browser when your OAuth client was created as "Web application" instead of "Desktop app". Desktop apps sign in via http://127.0.0.1:<random port>, which Google only permits for Desktop-app clients.

Fix: in Google Cloud Console go to APIs & Services → Credentials → Create Credentials → OAuth client ID, pick Application type: Desktop app, then paste the new Client ID and Secret into the app (login screen → Use different API keys). You can delete the old Web client.

"App has not been verified" / access blocked

Add your Gmail address under OAuth consent screen → Test users. Test apps can only be used by listed test users.

Sign-in never finishes

The browser tab must end on a "Signed in!" page. If your firewall prompts about the app listening on 127.0.0.1, allow it — that's the one-shot local listener Google redirects back to.

Build from source

Prerequisites (Windows): Node.js 20+, Rust, Visual Studio C++ Build Tools (check "Desktop development with C++"), and WebView2 (usually already on Windows 10/11). Full checklist: https://tauri.app/start/prerequisites/

git clone https://github.com/RomanGumeniuk/stupid-simple.git
cd stupid-simple
npm install
npm run tauri dev     # development mode (first Rust compile takes a few minutes)
npm run tauri build   # installer ends up in src-tauri/target/release/bundle/

Optionally copy .env.example to .env and fill in your keys to bake them into your own build — then the app skips the key screen entirely. Don't commit .env (it's already in .gitignore).

Releasing

Push a tag like v1.0.1 (or run the Release workflow manually) and GitHub Actions builds the Windows installer and attaches it to a GitHub Release automatically.

Architecture (for the curious)

src/                   ← frontend (React + TS)
  lib/google.ts        ← OAuth + Google Calendar API v3 client
  lib/store.ts         ← Zustand: state + sync engine
  lib/notify.ts        ← notifications + date helpers
  components/          ← Sidebar, MonthView, WeekView, modals
src-tauri/
  src/lib.rs           ← the only Rust: OAuth loopback listener (pure std)

• OAuth: the standard desktop loopback flow — Rust binds a random port on 127.0.0.1, the app opens the system browser, Google redirects back to localhost with a code, and the code is exchanged for tokens. Exactly what VS Code and Spotify do. (Google's Device Flow is not an option here — it doesn't allow the Calendar scope.)
• Sync: mutations (create/patch/delete) hit the API immediately (optimistic UI with rollback); remote changes are pulled by polling every 60 s and after every mutation.
• Birthdays: plain Google events with RRULE:FREQ=YEARLY + reminders.overrides (10080 min = 7 days) + a marker in extendedProperties.private, so they also show up in regular Google Calendar on your phone.

Known limitations (v1)

• Only the primary calendar is synced — multi-calendar support would be a good v1.1
• Editing a single occurrence of a recurring event changes that occurrence (that's how the API returns them with singleEvents=true)
• Tokens live in the app window's localStorage — fine for personal use; v2 could move them to the system keychain

License

MIT