Velohost Velohost

Astro Integration

Astro Fatsoma

An SSR-first Fatsoma events integration for Astro — predictable server-side data with no frontend bloat.

Usage snapshot

605
Downloads in the last 30 days
Latest npm version · v2.0.0
Source: npm registry

Why this plugin exists

Event platforms like Fatsoma require live data and cannot be truthfully handled at build time.

Astro Fatsoma is intentionally SSR-first, fetching events on the server with strict caching and failure safety.

This keeps pages fast, predictable, and free from client-side JavaScript or runtime hacks.

What it delivers

Design principles

  • SSR-first by design
  • No frontend JavaScript
  • Predictable caching
  • Failure-safe data access
  • Honest runtime behaviour

What this plugin does

  • Server-side Fatsoma event fetching
  • Clean, stable public event schema
  • In-memory cache with TTL
  • Timeout-protected API requests
  • Stale-while-revalidate behaviour
  • No client-side JavaScript
  • Safe for SSR and hybrid Astro output

Installation

npm install astro-fatsoma

This plugin runs server-side and requires SSR or hybrid output in Astro.

Project links

Source code, releases, documentation, and contribution guidelines.

Want the deep dive?

Read the FAQs for implementation details, design rationale, and integration guidance.

View plugin FAQs