(keine Änderung, nur Formatierung falls nötig)

Public UI – Desy Theme

Das Zoll Design System (Desy) ist der öffentliche Styleguide der Generalzolldirektion (Zoll). Dieses Paket stellt zum Styleguide passende Theme für die Public UI Web Component Library versioniert bereit.

Hinweis: Das Design System wird permanent weiterentwickelt und dieses Theme wird in regelmäßigen Abständen auf eine vereinbarte neuerere Version aktualisiert. Es kann daher vorkommen, dass das Theme nicht immer 100% mit der aktuellsten Version des Design Systems übereinstimmt. Aktuell ist das Theme auf die Version 11 des Design Systems abgestimmt.

Installation & Integration

npm install @public-ui/components @public-ui/theme-desy

React-Beispiel:

import { register } from '@public-ui/components';
import { defineCustomElements } from '@public-ui/components/loader';
import { DesyV11 } from '@public-ui/theme-desy';

register(DesyV11, defineCustomElements).then(() => {
	ReactDOM.createRoot(document.getElementById('root')).render(
		<React.StrictMode>
			<KolButton _label="Klick mich!" />
		</React.StrictMode>,
	);
});

Weitere Details: Getting started

Beitrag zum Theme (Contribution)

Du möchtest das Desy-Theme verbessern oder anpassen? So gehst du vor:

1. pnpm installieren

   • pnpm wird für die Entwicklung benötigt. Installiere pnpm global, falls noch nicht vorhanden:

     npm install -g pnpm

2. Repository forken

   • Klicke auf Fork auf GitHub und erstelle deinen eigenen Fork.

3. Lokales Setup

   • Klone deinen Fork:

     git clone https://github.com/<DEIN_GITHUB_USER>/kolibri.git
     cd kolibri/lib/packages/themes/desy

   • Installiere die Abhängigkeiten im Monorepo-Hauptverzeichnis:

     pnpm i
     pnpm build

4. Entwicklung starten

   • Wechsle ins Theme-Verzeichnis und starte den Watch-Modus:

     cd kolibri/lib/packages/themes/desy
     pnpm start

   • Passe die Dateien in src/ nach deinen Wünschen an.

5. Commit & Pull Request

   • Committe deine Änderungen und pushe sie in deinen Fork:

     git add .
     git commit -m "feat(theme-desy): <deine Änderung>"
     git push origin <dein-branch>

   • Erstelle einen Pull Request auf https://github.com/public-ui/kolibri/compare

Hinweise:

• Bitte halte dich an die Contributing Guidelines.
• Vor dem Commit immer pnpm format und pnpm lint ausführen.
• Für größere Änderungen gerne vorab ein Issue eröffnen.

Weitere Informationen

• Dokumentation
• Issues
• Pull Requests