Clock

TypeScript workspace for an embeddable analog event clock library and the official Analog Event Clock web application.

What Is Included

• packages/clock: reusable core library for time projection, event resolution, and SVG analog clock rendering.
• apps/web: official Beta web application, package @clock/web, version 0.1.0-beta.1.
• archive/legacy-app-screens: historical prototype screens kept outside the active app build.
• docs: product, architecture, testing, migration, and session handoff documentation.

Local Development

Install dependencies:

npm.cmd install

Run the official web application:

npm.cmd run dev

The app is served by Vite on 127.0.0.1.

Checks

npm.cmd run docs:check
npm.cmd run typecheck
npm.cmd test
npm.cmd run build
npm.cmd run build --workspace @clock/clock

Deploying To Vercel

Import the repository into Vercel and keep the project Root Directory at the repository root. The committed vercel.json configures:

• Node.js 24.x.
• npm ci for dependency installation.
• npm run build for the workspace build.
• apps/web/dist as the deployment output.
• An index.html fallback for direct SPA navigation.

No Vercel environment variables are currently required. After importing the repository, click Deploy; later pushes to the production branch will deploy automatically.

Documentation

Start with docs/README.md. The app migration is documented in docs/APP_MIGRATION.md.