Skip to content

GradeShelf v1.1.0 - Calendar subscriptions

Choose a tag to compare

@14flavius 14flavius released this 23 Oct 17:12

GradeShelf 1.1.0 adds private calendar subscriptions for your exams and grades.

Calendar subscriptions

  • Enable a read-only ICS subscription in Settings → Calendar subscription and use it in Apple Calendar, Outlook or another ICS-compatible calendar app.
  • Choose exactly which grade lists to include. Past and graded entries remain available; new lists are never added automatically.
  • Customize event titles and descriptions with variables for the entry, subject, list, grade type, date, status, grade, weight, note and link. Preview the result using an existing entry.
  • Copy a private subscription URL, replace it when needed or disable the subscription. Only a hash of the URL token is stored; the full URL is shown once after activation or replacement.
  • Use the settings and preview in English or German, including on mobile devices.

Stable updates and privacy

Each entry keeps its calendar ID when its title, date or grade changes. Feeds are generated from a consistent database snapshot and replace the cache only when complete. Failed generation never returns a partially built or accidentally empty successful calendar.

Feeds use a bounded 60-second server cache, conditional requests and rate limiting. Access is checked before cached responses are served, so disabling a subscription or replacing its URL revokes the old URL immediately. The calendar app controls its own refresh interval and may update less often.

Notes and grade values are excluded from the default templates; attachments are never included. Calendar settings are included in personal data exports without subscription credentials. Treat the subscription URL like a password, use HTTPS and exclude /calendar/ URLs from reverse-proxy logs. Replacing a URL does not remove copies already downloaded by a calendar app; update the existing subscription rather than adding a duplicate calendar.

Also changed

Removed the login tagline in both English and German.

Updating

From your installation directory:

sh scripts/backup.sh && docker compose pull && docker compose up -d --wait

The container applies the new Prisma migration on startup. Keep your existing .env and data/ directory. The migration adds calendar tables without replacing existing user data. If you pin your image version, change GRADESHELF_IMAGE to ghcr.io/14flavius/gradeshelf:1.1.0 first.

The release workflow publishes ghcr.io/14flavius/gradeshelf:1.1.0 and :latest for amd64 and arm64 after its build and persistence checks pass. Wait for the Publish Docker image workflow to finish before updating.

Validation

Production build, TypeScript, ESLint and Prisma validation passed. Isolated tests covered migration data preservation, ownership checks, URL revocation, cache expiry, stable IDs, concurrent reads and failure handling. Production HTTP routes and mobile browser interactions were checked. A live subscription in Apple Calendar itself has not yet been verified.