Proof of concept

Catholic Calendar

A deterministic, package-ready calendar engine for a curated Roman Catholic observance set. It resolves movable dates, liturgical and devotional periods, transfers, impediments and countdowns without an external API.

Model scopeCurated Roman calendar, with selected Marian observances and St Michael’s Lent

Interactive test

Calendar state tester

Select any supported civil date to inspect the three output layers, transfer decisions and the underlying movable-date calculations.

Composed calendar display

Our Lord Jesus Christ, King of the Universe

01

Primary observance

Our Lord Jesus Christ, King of the Universe

SolemnityObserved
02

Active periods

No selected period

03

Countdown

Suppressed today

A selected discrete observance is active. The engine still computes the next one for diagnostics.

Calculation details
Easter Sunday5 April 2026
First Sunday of Advent29 November 2026
Next observed celebrationFirst Sunday of Advent · 29 November 2026
Nominal selections today1

Visual QA

Year overview

Review the modelled periods, curated celebrations and liturgical-rank semantics for the selected year.

Year
2026

Periods

Periods in this model

These are the liturgical and devotional periods currently exposed by the calendar engine for the selected year. Periods that cross the turn of the year appear in both years.

Periods in 2026
IconPeriodKindStartEnd
star iconChristmas TimeLiturgical25 Dec 202511 Jan 2026
calvary iconLentLiturgical18 Feb 202602 Apr 2026
calvary iconHoly WeekLiturgical29 Mar 202604 Apr 2026
church iconSacred Paschal TriduumLiturgical02 Apr 202605 Apr 2026
easter egg iconEaster TimeLiturgical05 Apr 202624 May 2026
angel iconSt Michael's LentDevotional15 Aug 202629 Sep 2026
candle iconAdventLiturgical29 Nov 202624 Dec 2026
star iconChristmas TimeLiturgical25 Dec 202610 Jan 2027

Ordinary Time is intentionally not modelled in this curated implementation.

Celebrations

Celebrations in this model

The curated observances for the selected year, including transferred, commemorated and impeded entries.

Celebrations in 2026
DateIconCelebrationRankStatusNominal / reason
01 Janrosary iconMary, the Holy Mother of GodSanta María, Madre de DiosSolemnityObserved—
06 Jancross iconEpiphany of the LordEpifanía del SeñorPrincipal DayObserved—
11 Jandove iconBaptism of the LordBautismo del SeñorFeastObserved—
02 Febcross iconPresentation of the LordPresentación del SeñorFeastObserved—
11 Febrosary iconOur Lady of LourdesNuestra Señora de LourdesOptional MemorialObserved—
18 Febcalvary iconAsh WednesdayMiércoles de CenizaPrincipal DayObserved—
19 Marcross iconSaint Joseph, Spouse of the Blessed Virgin MarySan José, esposo de la Bienaventurada Virgen MaríaSolemnityObserved—
25 Marrosary iconAnnunciation of the LordAnunciación del SeñorSolemnityObserved—
29 Marcross iconPalm Sunday of the Passion of the LordDomingo de Ramos de la Pasión del SeñorPrincipal DayObserved—
02 Aprbread iconHoly ThursdayJueves SantoPrincipal DayObserved—
03 Aprcalvary iconGood Friday of the Passion of the LordViernes Santo de la Pasión del SeñorPrincipal DayObserved—
04 Aprcross iconHoly SaturdaySábado SantoPrincipal DayObserved—
05 Aprcross iconEaster Sunday of the Resurrection of the LordDomingo de Pascua de la Resurrección del SeñorPrincipal DayObserved—
12 Aprcross iconDivine Mercy SundayDomingo de la Divina MisericordiaPrincipal DayObserved—
16 Aprrosary iconSaint Bernadette SoubirousSanta Bernardita SoubirousOptional MemorialObserved—
13 Mayrosary iconOur Lady of FatimaNuestra Señora de FátimaOptional MemorialObserved—
14 Maycross iconAscension of the LordAscensión del SeñorPrincipal DayObserved—
24 Mayfire iconPentecost SundayDomingo de PentecostésPrincipal DayObserved—
25 Mayrosary iconBlessed Virgin Mary, Mother of the ChurchBienaventurada Virgen María, Madre de la IglesiaMemorialObserved—
31 Maytrinity iconMost Holy TrinitySantísima TrinidadSolemnityObserved—
31 Mayrosary iconVisitation of the Blessed Virgin MaryVisitación de la Bienaventurada Virgen MaríaFeastImpededImpeded by Most Holy Trinity
04 Junchalice iconCorpus ChristiSantísimo Cuerpo y Sangre de CristoSolemnityObserved—
12 Junsacred heart iconMost Sacred Heart of JesusSagrado Corazón de JesúsSolemnityObserved—
13 Junrosary iconImmaculate Heart of the Blessed Virgin MaryInmaculado Corazón de la Bienaventurada Virgen MaríaMemorialObserved—
24 Jundove iconNativity of Saint John the BaptistNatividad de San Juan BautistaSolemnityObserved—
29 Junst peter iconSaints Peter and Paul, ApostlesSantos Pedro y Pablo, apóstolesSolemnityObserved—
11 Julcross iconSaint Benedict of NursiaSan Benito de NursiaMemorialObserved—
16 Julrosary iconOur Lady of Mount CarmelNuestra Señora del CarmenOptional MemorialObserved—
06 Augcross iconTransfiguration of the LordTransfiguración del SeñorFeastObserved—
15 Augrosary iconAssumption of the Blessed Virgin MaryAsunción de la Bienaventurada Virgen MaríaSolemnityObserved—
22 Augrosary iconQueenship of the Blessed Virgin MaryBienaventurada Virgen María ReinaMemorialObserved—
08 Seprosary iconNativity of the Blessed Virgin MaryNatividad de la Santísima Virgen MaríaFeastObserved—
14 Sepcross iconExaltation of the Holy CrossExaltación de la Santa CruzFeastObserved—
15 Seprosary iconOur Lady of SorrowsNuestra Señora de los DoloresMemorialObserved—
29 Sepangel iconSaints Michael, Gabriel and Raphael, ArchangelsSantos Miguel, Gabriel y Rafael, arcángelesFeastObserved—
04 Octcross iconSaint Francis of AssisiSan Francisco de AsísMemorialImpededImpeded by Sunday
07 Octrosary iconOur Lady of the RosaryNuestra Señora del RosarioMemorialObserved—
01 Novcross iconAll SaintsTodos los SantosSolemnityObserved—
02 Novtombstone iconAll SoulsConmemoración de todos los fieles difuntosCommemorationObserved—
21 Novrosary iconPresentation of the Blessed Virgin MaryPresentación de la Santísima Virgen MaríaMemorialObserved—
22 Novcross iconOur Lord Jesus Christ, King of the UniverseNuestro Señor Jesucristo, Rey del UniversoSolemnityObserved—
29 Novcandle iconFirst Sunday of AdventPrimer Domingo de AdvientoPrincipal DayObserved—
08 Decrosary iconImmaculate ConceptionInmaculada ConcepciónSolemnityObserved—
10 Decrosary iconOur Lady of LoretoNuestra Señora de LoretoOptional MemorialObserved—
12 Decrosary iconOur Lady of GuadalupeNuestra Señora de GuadalupeOptional MemorialObserved—
25 Decstar iconChristmasNatividad del SeñorPrincipal DayObserved—
27 Deccross iconHoly Family of Jesus, Mary and JosephSagrada Familia de Jesús, María y JoséFeastObserved—

Proof-of-concept notes

Three layers

Independent outputs

Primary celebration, active periods and countdown state are computed separately so Advent, Lent or St Michael’s Lent never hides a feast.

Transfers

Nominal ≠ observed

Transfer and impediment metadata stay explicit. The tester can therefore show what normally belongs to a date without mislabelling it as the observed liturgy.

Integration

Prepared for packaging

Everything under lib/catholic-calendar is UI-agnostic TypeScript, ready to extract later for the Academic Website, Research Dashboard or other apps.

Release notes

v0.1.0-beta.2 “Ivory Delta”

ReleasedReleased on

Ivory Delta follows a full audit of the calendar engine, the demonstration app and the release process. It fixes a date-entry crash, makes the interface more accessible and dates the release history.

Calendar engine

  • Names the celebration that takes precedence when another is impeded, such as Ash Wednesday or Most Holy Trinity.
  • Keeps the countdown running through the last days of 2100 and adds a check for supported dates.

Interface

  • Prevents the page from failing when a partial or unsupported date is typed, and adds an error page.
  • Improves contrast, focus and screen-reader support, and shows release dates beside earlier versions.

Security and checks

  • Updates Next.js to resolve published security advisories.
  • Tests every Easter date from 2000 to 2100 and runs CI on Node 22 and 24.