Headless Drupal + NASA Space Calendar

A full-stack headless CMS integration that connects a Drupal 11 backend to a Next.js 16 frontend, pulling live space weather event data from NASA's DONKI

Link to Calendar API project:
https://franciscojavierguardado101-book-1-f.vercel.app/calendar

GitHub repo of headless-drupal-nasa-space-calendar:
https://github.com/franciscojavierguardado101/headless-drupal-nasa-space-calendar
 

Stack

  • CMS: Drupal 11 (PHP 8.3)
  • Frontend: Next.js 16, React, TypeScript
  • API: NASA DONKI (https://api.nasa.gov)
  • Hosting: Pantheon (Drupal) + Vercel (Next.js)

Headless Drupal + NASA Space Calendar

A full-stack headless CMS integration that connects a Drupal 11 backend to a Next.js 16 frontend, pulling live space weather event data from NASA's DONKI (Database Of Notifications, Knowledge, Information) API.

Built as part of a portfolio project demonstrating headless Drupal architecture, CMS-driven configuration, and real-time government API integration.

What it does

  • Displays live solar flare (FLR), coronal mass ejection (CME), geomagnetic storm (GST), and solar energetic particle (SEP) events from NASA DONKI
  • Interactive monthly calendar grid with event indicators per day
  • Clicking a day shows detailed event cards with begin time, peak time, source location, and a link to the NASA report
  • Event type tabs let users switch between the four event categories
  • All API credentials and configuration are managed entirely from the Drupal CMS admin — no environment variables or code changes needed to swap the API key or provider

How to use the paragraph

  1. Enable the module: drush en francisco_space_calendar
  2. Configure your NASA API key at /admin/config/services/space-calendar
  3. Add the Space Calendar paragraph to any content type via field_components
  4. Create a node, add the paragraph, set a URL alias, and the calendar appears at that URL

The paragraph works on any content type — it is not locked to a specific page or route.
 

Drupal module endpoints

Endpoint Description
GET /api/space-calendar/config Returns API base URL, key, and cache TTL
GET /api/resolve-path?path=/calendar Resolves any Drupal path alias to node type and UUID