Cathedral

An atmospheric interactive e-novel web app about misjudgment, listening, and emotional transformation.

Run In Development

npm install
npm run dev

Then open the local Vite URL in a browser.

Build

npm run build

The production build is written to dist/.

Installable Web App For iPad Safari

The app now includes:

• a web app manifest
• Apple touch icons for iPad and iPhone
• service worker caching for offline reopening after the first online visit
• safe-area handling for Home Screen launch on iPadOS
• local progress persistence on the device

To use it on an iPad:

1. Host the built site or the dist/ folder at an HTTPS URL.
2. Open that URL in Safari on the iPad.
3. Tap Share -> Add to Home Screen.
4. Open it once while online so the app shell is cached.

After that, it can reopen from the Home Screen like a standalone app.

To create a host-ready static package:

npm run package:web

That writes a deployable bundle to release/Cathedral Web/.

Deploy To Vercel

This project is ready for Vercel.

If you push it to GitHub, import the repository into Vercel and use these settings:

• Framework Preset: Vite
• Build Command: npm run build
• Output Directory: dist

Those settings are also stored in vercel.json.

If you do not want to connect a git provider, you can also deploy the static build by uploading the contents of:

• release/Cathedral Web/site/

Click-To-Run Mac Package

Build the shareable Mac package with:

npm run package:mac

This creates a self-contained folder in release/ with:

• Cathedral.app
• a local site/ folder containing the built story
• Open Cathedral.command as a fallback launcher
• a .zip ready to share

Open the app and it launches the story in the default browser.

Experience Highlights

• Poster-like landing screen with cinematic motion
• Guided six-section literary journey
• Reader choices that alter tone and inner narration
• Reflection prompts and marginalia
• Live “reader influence” panel tracking emotional movement
• Responsive layout for desktop and mobile