SOS for Cuba

A content-first redesign of sosforcuba.com built with Next.js, TypeScript, React, and MDX.

What is included

• Advocacy-first homepage with recent articles
• English MDX content with a locale-ready directory structure
• Article archive with client-side search and tag filters
• Article tag pages, RSS, sitemap, robots metadata, and social metadata
• Permanent redirects from important Gatsby URLs
• Responsive editorial design with accessible navigation and reduced-motion support
• HLS playback for preserved legacy videos

The old protest database, submission forms, Fauna integration, donations, Mailchimp, LogRocket, and COVID-era content are intentionally excluded.

Local development

npm install
npm run dev

Then open http://localhost:3000.

Before publishing:

npm run typecheck
npm run lint
npm run build

Add an article

Create content/en/articles/my-article.mdx:

---
title: "Article title"
description: "A concise search and social description."
date: "2026-07-31"
author: "SOS for Cuba"
tags: ["Human rights", "Cuba"]
cover: "/media/legacy/example.jpg"
coverAlt: "Describe the image for readers using assistive technology"
featured: false
draft: false
---

Your article begins here.

Available MDX components:

<MediaImage src="/media/legacy/example.jpg" alt="Required alt text" caption="Optional caption" />
<Video src="https://example.com/video.m3u8" poster="https://example.com/poster.jpg" title="Required title" />
<Callout title="Optional label">Important context.</Callout>
<SourceLink href="https://example.com/source">Source title</SourceLink>

Articles are discovered automatically. No registry file needs to be edited.

Add Spanish later

English source lives under content/en. Add translated material under content/es with the same slugs, then introduce a locale route segment and locale switcher. Keeping slugs aligned makes cross-language linking and canonical metadata straightforward.

Media

Images used by the migrated pages are preserved under public/media/legacy. The specific 2020 COVID image, Gatsby starter artwork, unused form artwork, and graphic images that are not presented in this edition were not migrated; the original repository remains the complete legacy archive.