--- title: "Version 1.0.0" url: "https://twistcal.com/changelog/v1.0.0" description: "First stable release — web component, declarative triggers, programmatic API, 12 languages, all-day events, keyboard nav, custom calendars." --- ## What’s new First stable release of TwistCal — a lightweight, zero-dependency “Add to Calendar” web component with Shadow DOM. ### Three usage modes - **Web component** — `` renders a styled dropdown button with Google, Outlook, Yahoo, and .ics - **Declarative triggers** — `data-twistcal` attributes on any element, auto-initialized - **Programmatic API** — import URL generators and ICS builder directly ### Features - **Shadow DOM** style isolation — styles don’t leak in or out - **12 languages** with auto-detection from `lang` attribute, ``, or `navigator.language` - **Button variants** — `solid` (default) and `outline` (white bg, dark border) - **Calendar selection** — `calendars="google,ics"` to pick which services to show and in what order - **Icon toggles** — `show-icons` (dropdown) and `show-icon` (button), both on by default - **Brand SVG icons** — Google Calendar (classic “31”), Outlook, Yahoo, Apple Calendar - **Full CSS theming** — 25+ `--tc-*` custom properties for every visual value - **Slim builds** — no icons, drops ~8 KB (19 KB → 11 KB) - **Generators split** — `src/generators.js` importable without the web component (3 KB) - **TypeScript declarations** — `.d.ts` for full and generators builds - **All-day events** — `all-day="true"` attribute, date-only ICS and Google/Yahoo formats - **Event callback** — `twistcal:add` CustomEvent with `{ action, event }` detail - **Custom calendar services** — `addCalendar(id, label, icon, urlFn)` API - **Keyboard navigation** — ArrowUp/Down, Home/End, Escape, auto-focus first item - **Branding** — “Powered by TwistCal” link in dropdown, `branding="false"` to hide - **Calendar icon** on the button, using `currentColor`, baked into all builds - **Timezone support** — DST-aware via `Intl.DateTimeFormat`, IANA names - **JSON event data** — ` ``` ### License Apache-2.0 © [FreshJuice](https://freshjuice.dev/?utm_source=twistcal.com)