CalSnap
Custom Calendars for TeamSnap

CalSnap delivers custom team calendar that are more detailed, clear, and usable. CalSnap deploys as a Cloudflare Worker (serverless function), connects to your TeamSnap account, and serves .ics iCalendar subscriptions for each team.

“TeamSnap already has calendars! Why use this?”

While TeamSnap supports calendar subscriptions, events lack useful information, team names can be too long, and descriptions are messy.

CalSnap uses the TeamSnap API so that your calendars include:

• a custom team name (shorter or more descriptive)
• links to TeamSnap event pages
• arrival times (minutes early)
• event notes by team manager or coach

1. Workers & Pages ⇢ Create an application ⇢ Clone a repository
2. Git repository URL:

   http://github.com/andesco/calsnap
   

1. Create a Cloudflare Workers KV namespace with Wrangler CLI and note the new namespace ID:

   git clone https://github.com/andesco/calsnap.git
   cd calsnap
   wrangler kv namespace create "CALSNAP_CALENDAR_STORE"

2. Update wrangler.toml with the new KV namespace ID and set your environment variables:

   [[kv_namespaces]]
   binding = "CALSNAP_CALENDAR_STORE"
   id = "{new KV namespace ID}"

3. Deploy with Wrangler CLI:

   wrangler deploy

4. Note your new worker URL from the output:
    
   https://calsnap.{subdomain}.workers.dev

1. TeamSnap authentication ⇢ Your Account ⇢ Your Applications ⇢ New Application

2. Name: TeamSnap Custom Calendar
   Description: Cloudflare Worker
   Redirect URI: https://calsnap.{subdomain}.workers.dev

3. Client ID: {your Client ID}
   Client Secret: {your Client Secret}

1. Workers & Pages ⇢ {worker} ⇢ Settings: Variables and Secrets: Add:
2. Type: Text
   Variable name: TEAMSNAP_CLIENT_ID
   Value: {your Client ID}
3. Type: Secret
   Variable name: TEAMSNAP_CLIENT_SECRET
   Value: {your Client Secret}

1. set your environment variables wrangler.toml:

   [vars]
   ALLOWED_USER_EMAIL = "{your TeamSnap email}"
   TEAMSNAP_CLIENT_ID = "{your Client ID}"

2. Set your secrets with Wrangler CLI:

   wrangler secret put TEAMSNAP_CLIENT_SECRET

1. Open your Cloudflare Worker in a browser: https://calsnap.{subdomain}.workers.dev
2. Authenticate with TeamSnap.