Wie man den Add to Calendar Button mit Next.js nutzt

Schritt 1: npm Installation

Da Next.js auf React 19 aufsetzt, werden Web Components vollständig out-of-the-box unterstützt. Nutze den Add to Calendar Button Web Component einfach direkt.

Installiere das Package über die npm Registry.

npm install add-to-calendar-button

Schritt 2: Import

Importiere das Modul in deine Komponente, in welcher du den Button nutzen möchtest.

import 'add-to-calendar-button';

Schritt 3: Loslegen

Beginne mit der Nutzung, indem du einen <add-to-calendar-button> Tag in deinem HTML-Quellcode einfügst - mit den Optionen als Attribute.

Ganz genau - es ist derart einfach.

Dein Code kann hierbei bspw. wie folgt aussehen.

<add-to-calendar-button
  name="Titel"
  options="'apple','google'"
  location="World Wide Web"
  start-date="2026-09-10"
  end-date="2026-09-10"
  start-time="10:15"
  end-time="23:30"
  time-zone="Europe/Berlin"
  language="de"
></add-to-calendar-button>

Beachte, dass der Button nur client-seitig funktioniert! Nutze 'use client'; entsprechend.

Stile & Sprachen

Das Skript wird mit dem "default"-Button-Style und dem englischen Sprachpaket ausgeliefert - der Button sieht also von Haus aus gut aus und funktioniert ohne jegliche zusätzliche Konfiguration.

Jeder weitere Style und jede weitere Sprache lädt automatisch bei Bedarf (jeweils wenige KB), sobald du sie referenzierst - kein manuelles Wiring nötig.

Bundling via npm (empfohlen für Frameworks)

Wenn du das Skript bundlest, importiere die gewünschten Style- und Sprachmodule, damit sie zur Build-Zeit ohne Netzwerk-Anfrage registriert werden. Füge einfach die entsprechenden Import-Anweisungen irgendwo in deiner Entry-Datei (oder der Komponente, die den Button nutzt) hinzu:

import 'add-to-calendar-button/styles/3d';   // any style besides "default"
import 'add-to-calendar-button/i18n/de';       // any language besides English

Siehe die Optionen "button-style" und "language" auf der Konfigurations-Seite für alle Details.

Server Side Rendering (SSR)

Der Button kann zusätzlich eine Hülle auf dem Server vor-rendern - für ein sofortiges, layout-stabiles erstes Zeichnen. Siehe den "Server-seitiges Rendern"-Abschnitt auf der Profi-Funktionen-Seite. Server-seitiges Rendern

Ein komplettes Beispiel könnte so aussehen.

// app/components/atcb-client.tsx (client upgrade)
'use client';
import 'add-to-calendar-button';

type AtcbClientProps = {
  html: { __html: string };
};

export default function AtcbClient({ html }: AtcbClientProps) {
  return <div dangerouslySetInnerHTML={html} />;
}

// app/page.tsx (server component)
import { atcb_generate_ssr_html } from 'add-to-calendar-button/ssr';
import AtcbClient from './components/atcb-client';

export default function Page() {
  const html = {
    __html: atcb_generate_ssr_html({
      name: 'Reminder to check the add-to-calendar-button demo',
      options: ['Apple', 'Google'],
      location: 'World Wide Web',
      startDate: '2026-09-10',
      endDate: '2026-09-10',
      startTime: '10:15',
      endTime: '23:30',
      timeZone: 'Europe/Berlin',
    }),
  };
  return <AtcbClient html={html} />;
}