Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

breviarium

Breviarium-app966MIT3.0.4TypeScript support: included

Typescript library that generates liturgical calendars and praying content of the Roman Rite of the Roman Catholic Church

roman, liturgy of the hours, prayer, catholic, calendar, latin, western, church, christian, seasons, liturgical

readme

Breviarium 🙏🏼

Open source Liturgy of the Hours, collaborate to build the best Divine Office library!

Generates liturgical content and calendars of the Roman Rite of the Roman Catholic Church.
Supports Node v18+, Modern Browsers (desktop and mobile).

License npm breviarium version latest latest minzipped size

Quickstart setup

  1. Install with your prefered package manager `shell [npm] npm install breviarium

    ```shell [pnpm]
pnpm install breviarium

    shell [yarn] yarn add breviarium

  2. Import and use the library to retrieve the desired data (ex: Laudes) Usage: `ts const breviarium = new Breviarium(useDateStore().getCurrentDate);

// get laudes for today await breviarium.getLaudes().then((data) => { console.log("laudes data:", data) })


```ts
const breviarium = new Breviarium(useDateStore().getCurrentDate);

// get laudes for a given date (example for 2025-7-30)
await breviarium.getLaudes(new Date(2025, 6, 30)).then((data) => { console.log("laudes data:", data) })

Function Documentation

Liturgy of the hours: functions to retrieve the information of the library:

Function Parameters Description Example Call
getLaudes date?: Date Returns the Laudes prayer for a given date. prayers.getLaudes();
getVesperae date?: Date Returns the Vesperae prayer for a given date. prayers.getVesperae(new Date(2025, 1, 17));
getOfficium date?: Date Returns the Officium prayer for a given date. prayers.getOfficium();
getTertia date?: Date Returns the Tertia prayer for a given date. prayers.getTertia();
getSexta date?: Date Returns the Sexta prayer for a given date. prayers.getSexta(new Date());
getNona date?: Date Returns the Nona prayer for a given date. prayers.getNona();
getCompletorium date?: Date Returns the Completorium prayer for a given date. prayers.getCompletorium();
getMissaleLectiones date?: Date Returns the Mass readings prayer for a given date. prayers.getMissaleLectiones();
getEvangelium date?: Date Returns the Gospel text for a given date. prayers.getEvangelium(new Date(2025, 5, 1));

Test

To run the test suite (with vitest), execute:

To run the app:

# linux and mac users:
make test
# for windows users:
npm run test

Changelog

See Changelog.md for breaking changes.

changelog

Changelog

Breviarium major changes through versions.

v3.0

  • feat: getVesperae() returns an array of elements to pray instead of just one. Merge memorial with ferial if needed.
  • fix: Officium lectiones if memorial in same day. Merge content of ferial and memory

v2

  • feat: getLaudes() returns an array of elements to pray instead of just one

v1

  • All functionality of liturgy of the hours