How untypequicode/celcat-scraping works
Celcat → ICS turns a pasted Celcat calendar URL or manually entered resource into a shareable ICS endpoint link. The frontend parses and validates source and date options, then the backend fetches Celcat events, deduplicates and converts them into a calendar response, with caching. The UI also supports custom event colors, quick-add links, SEO metadata, and light/dark appearance. Backend fetching and conversion are visible in the sampled Rust excerpts; component wiring beyond the sampled frontend files is limited to documented or excerpted references.
Main entry points: app.vue Page orchestration · main.rs HTTP API & routing · celcat.rs Calendar generation · useCalendarForm.ts Form state & link
Components 18
Calendar web app
- Calendar form UI
frontend/app/components/form - Page orchestration
frontend/app/app.vue - Form state & link
frontend/app/composables/useCalendarForm.ts - Celcat URL parser
frontend/app/composables/useCelcatUrlParser.ts - Result & quick-add
frontend/app/components/result - Theme preference
frontend/app/composables/useColorScheme.ts - Theme initialization
frontend/app/plugins/color-scheme.client.ts - SEO metadata
frontend/app/composables/useSiteSeo.ts
Calendar API
- HTTP API & routing
backend/src/main.rs - ICS response cache
backend/src/main.rs
Celcat integration
- Calendar generation
backend/src/celcat.rs - Weekly event retrieval
backend/src/celcat.rs - Event deduplication
backend/src/celcat.rs
Calendar conversion
- Event detail parsing
backend/src/celcat.rs - ICS construction
backend/src/celcat.rs
Other components
- Calendar user
- Celcat calendar service
- Calendar app
Connections 17
- Calendar user → Calendar form UI: enters options
frontend/app/components/form/SourceStep.vue - Page orchestration → Calendar form UI: renders form
frontend/app/app.vue - Page orchestration → Form state & link: uses form state
frontend/app/app.vue - Form state & link → Celcat URL parser: parses pasted URL
frontend/app/composables/useCalendarForm.ts - Page orchestration → Result & quick-add: renders result
frontend/app/app.vue - Form state & link → HTTP API & routing: builds endpoint link
frontend/app/composables/useCalendarForm.ts - Page orchestration → SEO metadata: sets page metadata
frontend/app/app.vue - Theme initialization → Theme preference: initializes theme
frontend/app/plugins/color-scheme.client.ts - HTTP API & routing → ICS response cache: reads and writes
backend/src/main.rs - HTTP API & routing → Calendar generation: generates calendar
backend/src/main.rs - Calendar generation → Weekly event retrieval: fetches weeks
backend/src/celcat.rs - Weekly event retrieval → Celcat calendar service: requests events
backend/src/celcat.rs - Calendar generation → Event deduplication: deduplicates events
backend/src/celcat.rs - Calendar generation → ICS construction: builds calendar
backend/src/celcat.rs - ICS construction → Event detail parsing: parses event details
backend/src/celcat.rs - HTTP API & routing → Calendar app: serves ICS
- Calendar user → Theme preference: changes appearance