• Blog
  • Docs
  • Pricing
  • We’re hiring!
Log inSign up
project logo

sohan

ShireCal

Public
Like
ShireCal
Home
Code
8
.git
7
scripts
1
.vtignore
README.md
agents.md
deno.json
events.json
H
main.tsx
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
README.md
Code
/
README.md
Search
9/29/2025
Viewing readonly version of main branch: v41
View latest version
README.md

Shire

Shire serves an iCalendar (.ics) feed of Middle Earth Events.

Routes

  • GET / – Returns an .ics file with the next occurrence of every stored event.
  • GET /?format=json – Returns the currently stored events as JSON.
  • PUT / – Replaces all stored events. Body must be JSON shaped like { "events": ShireEvent[] }.

Event shape

Create val
interface ShireEvent { start: string; // MM-DD end?: string; // MM-DD (optional) text: string; // Event title/description }
  • start and end are month/day strings (MM-DD).
  • Leave end blank for single-day events.
  • When end is earlier than start (e.g. 12-29 to 01-02), the event wraps into the next year automatically.
FeaturesVersion controlCode intelligenceCLIMCP
Use cases
TeamsAI agentsSlackGTM
DocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
PricingNewsletterBlogAboutCareers
We’re hiring!
Brandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Open Source Pledge
Terms of usePrivacy policyAbuse contact
© 2026 Val Town, Inc.