Skip to content
Now in Public Beta

Italian American Heritage Archive

An AI-powered oral history platform built for Italian American families — turning a single recorded voice into a publishable heritage story.

The Problem

Voices are disappearing every month

The generation of Italian Americans who remember the old neighborhoods, the Sunday dinners, the voyage across the Atlantic — they're in their 60s to 90s. Every month, irreplaceable stories vanish forever. Most families never get around to recording them. The process feels too complicated, too technical, too easy to put off.

The Solution

One link. One tap. One story. Forever.

A family organizer picks a culturally specific prompt, copies a link, and texts it to Grandma. She taps the link, sees one question in giant text, taps one green button, and tells her story. Our Heritage Preserver tool handles everything else — transcription, AI narrative generation, photos, maps, and publishing to the Italian American Heritage Archive.

Getting Started

Quick Start: Try it in 5 Minutes

01

Open the Admin Panel

Go to /admin

This is the family organizer's control center. You'll see the full prompt library organized by Italian American cultural category.

02

Pick a Prompt

Browse & select

Choose any prompt from La Cucina, La Famiglia, Il Quartiere, or the other categories. Each prompt is crafted to draw out a specific memory or story.

03

Copy the Recording Link

Click "Copy Link"

The admin generates a direct URL to the elder-friendly recording interface pre-loaded with that prompt. In real use, you'd text or email this to a family member.

04

Record a Story

Open the link — record yourself

The recording page is intentionally simple: one question, one big green button. Tap Record, tell a 30–90 second story, tap Stop, then Submit.

05

Process with AI

Go to /admin/recordings

Your recording appears here. Click "Process" to run the full pipeline: Deepgram transcribes the audio, then Claude generates the magazine narrative, pull quote, themes, locations, and photo queries.

06

Publish & Share

Go to /admin/publish

Toggle the story to "Public" and it immediately appears in the Heritage Archive. Copy the share link or iframe embed code to put it anywhere.

Platform Stats

Built in one day. Growing every week.

31
Interview Prompts
6 cultural categories
~10
Hours to Build
Pi Day, March 14
4
Edge Functions
AI pipeline + API
5
AI Steps
Per recording processed

Prompt Library

La Cucina6 prompts
La Famiglia6 prompts
Il Quartiere5 prompts
Immigration & Identity6 prompts
Faith & Traditions4 prompts
Lingua e Dialetto4 prompts

Claude Usage per Story

System prompt~120 tokens
Transcript input~800 tokens
JSON output~1,200 tokens
Total per call~2,100 tokens
Model: Claude Sonnet 4.6 · Platform: Bolt.new Pro
AI Processing Pipeline

From audio to published story in 5 steps

Step 1

Upload

Browser MediaRecorder API + Supabase Storage

Audio is captured in the browser via the MediaRecorder API and uploaded directly to Supabase Storage using the tus resumable upload protocol.

Step 2

Transcribe

Deepgram Nova-2

The Edge Function generates a signed storage URL and sends it to Deepgram Nova-2 with smart_format and paragraphs enabled. Returns a clean, punctuated transcript.

Step 3

Analyze

Anthropic Claude Sonnet 4

Claude receives the transcript and a crafted system prompt. It returns structured JSON: narrative, pull quote, themes, names, places, photo queries, and location data.

Step 4

Enrich

Pexels API

Claude's three atmospheric photo queries are sent to Pexels. The first valid result for each is cached in the story_metadata row so the story page loads instantly.

Step 5

Publish

Supabase PostgreSQL + Public API

The completed story is stored in story_metadata. When toggled public, it appears in the archive and is served by the stories-api Edge Function as a public JSON endpoint.

Accessibility

Built for 80+ Year Old Users

WCAG AAA Contrast

7:1 ratio minimum throughout the recording interface

200px Touch Targets

Every button sized for elderly hands with low motor precision

6th-Grade Reading Level

All copy tested for readability by non-native English speakers

Linear 6-Screen Flow

Zero navigation, no back buttons, no modal dialogs anywhere

No Red UI Elements

Aging eyes struggle with red — every alert uses amber/gold

Mobile-First

Recorded on phones, designed for thumbs not mouse clicks

Shareability

Every Story is an Asset

Heritage stories are shareable by URL, embeddable anywhere via iframe, and accessible as structured JSON through the public API — ready for ItalianAmericans.com to feature in newsletters, social posts, and the website.

Public URL

Shareable link for every story

iFrame Embed

Drop any story into any website

JSON API

/functions/v1/stories-api

Social Ready

Heritage Card image via Edge Function

Tech Stack

What it's built on

Frontend

React 18, Vite, Tailwind CSS, React Router v6, Lucide Icons

Backend

Supabase PostgreSQL, Row Level Security, Supabase Storage, Edge Functions (Deno)

AI / ML

Anthropic Claude Sonnet 4, Deepgram Nova-2, Custom prompt engineering

Media & Maps

Pexels API (photography), Google Maps Embed API, tus resumable upload, Browser MediaRecorder API

Dev Environment

Bolt.new, Claude Sonnet 4.6 (agent), Pi Day — built in one day

Built by The Alghini Institute · Contact: Christopher Alghini — salve@italianamericans.com

Public Beta — Free to Join

Become a Beta Organizer

Create a free account and start preserving your family's stories today. As a beta organizer you get full access to every feature — recording links, AI processing, and the Heritage Archive.

In return, we ask for one thing: tell us what's broken, what's confusing, and what you'd love to see. Your feedback directly shapes the roadmap.