Calendar Booking Plugin

[olliethedev]

Overview

Add a calendar booking plugin that enables scheduling functionality for individuals and groups. Think "minimal Cal.com" - focused on the core booking experience without the complexity.

Core Features

Booking Types

• 1:1 bookings (individual with host)
• Group bookings (multiple attendees, single time slot)
• Round-robin assignment (distribute across team members) - stretch goal

Availability & Scheduling

• Configurable time blocks (15m, 30m, 45m, 1hr, custom)
• Weekly availability rules (e.g., Mon-Fri 9am-5pm)
• Date overrides (block specific days, add one-off availability)
• Booking limits (max bookings per hour/day/week, max capacity per booking/total, etc)

Booking Flow

• Public booking page per event type
• Timezone-aware slot selection
• Booking confirmation & cancellation
• Plugin Lifecycle hooks (confirmation, reminder, cancellation)

Management

• Event types CRUD (name, duration, description, location)
• Upcoming/past bookings dashboard
• Calendar sync (Google Calendar, Outlook) - stretch goal

Non-Goals (v1)

• Payments/invoicing
• Complex workflows/automations
• Video conferencing integrations
• Recurring bookings
• Waitlists

Plugin Structure

Following existing plugin patterns:

• API Plugin: Event types schema, bookings schema, availability rules, booking endpoints
• Client Plugin: Public booking page, dashboard, event type management

[Mouhamed-B]

Hello. Awesome framework you're building here. do you ship ui with shadcn only in client plugins ? I'm interested in working on this one.

[olliethedev]

Hi @Mouhamed-B, thanks for the kind words!
You're good to go on this one. 🚀

Happy to help if you get stuck.

A few pointers on the monorepo structure to get you going:

Plugin structure — follow the existing pattern (e.g. ai-chat or blog):

• packages/stack/src/plugins/calendar/api/plugin.ts — backend plugin (schema, routes, api factory)
• packages/stack/src/plugins/calendar/client/plugin.tsx — client plugin (routes, loaders, meta)

Shared UI — we have a @workspace/ui package that houses all Shadcn components and shared UI primitives used across plugins. Use it instead of installing Shadcn directly into the plugin:

import { Button } from "@workspace/ui/button"
import { Calendar } from "@workspace/ui/calendar" 

To add a missing Shadcn component, run pnpm dlx shadcn@latest add <component> from packages/ui/.

Build config — when you add new entry points, update both packages/stack/build.config.ts (entries array) and packages/stack/package.json (exports + typesVersions).

Check AGENTS.md at the repo root for the full rundown on patterns, hook naming conventions, SSR loaders, and example app updates.

Check out https://www.better-stack.ai/docs/plugins/development for 3rd part plugin dev info, but can also be helpful when working on native plugins.

Look forward to seeing this one come together!