Cycle Tracker — Setup Guide

lock_open

Step 1

Unlock the app

~1 min

Find your licence key

Check the email you used to purchase on Gumroad. Your unique key is in the receipt — it's 32 characters in four blocks, like ABCD1234-EFGH5678-IJKL9012-MNOP3456. You can also find it anytime in your Gumroad library.

Open the app

Go to cycle-tracker.com/app.html on your phone or browser. You'll see a welcome screen asking for your licence key.

Paste your key and tap Unlock

Paste your key into the field and tap Unlock App. The app verifies it instantly and lets you in. Your key is saved — you'll never need to enter it again on this device.

info Paste the whole key exactly as it appears in your receipt, dashes included. If you see "That key looks incomplete", part of it didn't make it across — copy it again from the email.

check_circle Your key works on any number of your own devices. Lost it? Find it again in your Gumroad library anytime.

table_chart

Step 2

Connect your Google Sheet

~5 min

info This is the only technical step. The app walks you through it automatically when you first unlock — but this guide has the full details if you need them.

auto_awesome

Start here — the ready-made template

This sheet already has the script inside it, so there's no code to copy or paste anywhere. Everything below assumes you've made your copy first.

content_copy Copy the template sheet Google will make a private copy in your own Drive — we can't see it.

Make your copy of the template

Click the pink button above and then Make a copy when Google asks. The new sheet lands in your own Google Drive and belongs entirely to you. Give it any name you like.

Grant permissions (one time only)

In your new sheet, open Extensions → Apps Script. Click the function dropdown next to the ▶ Run button, select setupCycleTracker, and click Run.

1. Click Review permissions

2. Choose your Google account

3. Click Advanced (small text at bottom)

4. Click Go to Cycle Tracker (unsafe)

5. Click Allow

info The "unsafe" wording is Google's standard warning for any script that hasn't gone through its paid verification process. It's asking whether you trust the script you just copied into your own account — it isn't a virus alert.

arrow_downward Here's where to find setupCycleTracker in the function dropdown:

Apps Script dropdown showing setupCycleTracker

Then go back to your sheet, refresh the page, and click Cycle Tracker → Setup & Format Sheet from the top menu. Your sheet will now have a Cycle Log tab and a Summary tab, formatted and ready.

Deploy as a Web App

Back in Apps Script, click Deploy → New deployment in the top right. Click the gear icon and choose Web app.

Set these exactly:

Execute as: Me

Who has access: Anyone

Click Deploy. Approve permissions if asked again.

shield "Anyone" sounds alarming but only means Google won't demand a login before running the script. The web app URL is long and random, and nobody can reach your sheet without it. Keep that URL to yourself.

Copy your Web App URL

After deploying you'll see a URL ending in /exec. Copy it — you'll paste it into the app next.

Connect it in the app

Back in Cycle Tracker, tap the settings Settings button in the top right. Paste your URL into the field and tap Save & Connect. A green dot confirms you're connected.

Log one test entry

Fill in a quick entry and save it, then open your Google Sheet and check that a new row appeared in the Cycle Log tab. This confirms the connection end to end — worth doing once before you rely on it.

check_circle Your Google Sheet lives in your Google Drive at drive.google.com. Every entry you log appears as a new row automatically.

update Redeploying later? Go to Deploy → Manage deployments → click the pencil icon → select New version → Deploy. Your URL stays the same, so you won't need to reconnect the app.

add_to_home_screen

Step 3

Add to your home screen

~1 min

phone_iphone

iPhone / iPad

Open the app in Safari — must be Safari, not Chrome.

1. Tap the ios_share Share button at the bottom of Safari

2. Scroll down and tap "Add to Home Screen"

3. Tap Add in the top right

android

Android

Open the app in Chrome.

1. A banner may appear — tap Install

2. If not, tap the ⋮ menu top right

3. Select "Add to Home Screen" or "Install app"

check_circle Once installed, the app opens full-screen with no browser bar — just like a native app. It also works offline after the first load.

help

If something goes wrong

Troubleshooting

key_off

"Invalid licence key"

Copy the key straight from your Gumroad receipt rather than retyping it — a single wrong character will fail. If it still won't unlock, email us and we'll check it against your purchase.

cloud_off

Entries aren't appearing in my sheet

Open Settings and check for the green dot. If it's there but rows still aren't arriving, the deployment likely needs redoing — go back to Apps Script and deploy a new version, then confirm the URL still ends in /exec.

menu_open

The "Cycle Tracker" menu isn't in my sheet

That menu only appears after the script has been authorised. Run setupCycleTracker from Apps Script as described in Step 2, then refresh the sheet.

phonelink_off

Setting up on a second device

Enter your licence key again, then paste the same web app URL into Settings. Both devices will write to the same sheet.

You're all set!