SavvyCal Appointments

A monorepo containing packages for building UIs on top of the SavvyCal Appointments API.

Packages

Package	Description
@savvycal/appointments-core	TypeScript/JavaScript client for the SavvyCal Appointments API
@savvycal/appointments-react-query	React Query hooks for data fetching and mutations
@savvycal/appointments-utils	Timezone-aware date/time utilities

Development

This project uses pnpm for package management.

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run development mode
pnpm dev

# Run tests
pnpm test

# Type check
pnpm typecheck

Updating the API changelog

This repo includes a Claude Code skill for updating the API changelog and generating changeset files. First, regenerate the API docs from the schema:

pnpm run generate

Then in Claude Code, run:

/update-changelog

Describe the changes (or let it inspect your staged/unstaged git diff) and it will:

1. Add a dated entry to site/docs/changelog.md
2. Create one .changeset/*.md file per changelog bullet with the appropriate package bumps

Review the proposed entries before confirming.

License

MIT