Astro Integration
Astro Fatsoma
An SSR-first Fatsoma events integration for Astro — predictable server-side data with no frontend bloat.
Last Updated: 01 April 2026
Usage Snapshot
284
Downloads in Last 30 Days
v2.1.0
Latest npm Version
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.
Design Principles
- SSR-first by design
- No frontend JavaScript
- Predictable caching
- Failure-safe data access
- Honest runtime behaviour
What This Plugin Delivers
- 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.
FAQs
Is Astro Fatsoma static?
No. Astro Fatsoma is SSR-first. It fetches live event data server-side with caching.
Does Astro Fatsoma add client-side JavaScript?
No. All data fetching happens on the server.
What happens if the Fatsoma API is unavailable?
Cached data is served if available. Otherwise, an empty result is returned safely.
Implementation FAQs
Why is Astro Fatsoma SSR-first?
Fatsoma event data is live and time-sensitive, making SSR the only honest approach.
Does Astro Fatsoma ship frontend JavaScript?
No. All logic runs server-side.
How does caching work?
Events are cached in memory with a fixed TTL and revalidated automatically.
Can I use this with fully static output?
No. Astro Fatsoma requires SSR or hybrid output.
What happens if the API fails?
Cached data is served if available. Otherwise, an empty array is returned safely.
Is Astro Fatsoma open source?
Yes. It is released under the MIT license.
Project Links
Source code, package distribution, releases, and documentation.
Need Implementation Details?
Read the FAQs for usage patterns, integration caveats, and rollout guidance.