À propos du projet
coss.com/ui (anciennement Origin UI) est décrit comme le système de design officiel de Cal.com. Le dépôt est un monorepo contenant plusieurs produits et applications, tous écrits en TypeScript et gérés avec Turborepo.
Structure du dépôt
Le monorepo liste ces applications et packages :
- apps/www/ — le site web principal coss.com
- apps/ui/ — la bibliothèque de composants coss ui et la documentation
- apps/origin/ — les composants legacy Origin UI, conservés comme un instantané pré-acquisition
- packages/ui/ — package de composants UI partagés
- packages/typescript-config/ — configurations TypeScript
- biome.json — configuration Biome partagée pour le linting et le formatage
Variables d'environnement
Comme plusieurs applications Next.js sont liées entre elles, chaque application a besoin de son propre fichier .env.local pour que la navigation inter-applications fonctionne localement. Le README documente les variables pour l'application www (NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_UI_URL), l'application ui (NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_URL, NEXT_PUBLIC_ORIGIN_URL) et l'application origin (NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_URL, NEXT_PUBLIC_COSS_UI_URL), avec des exemples de ports localhost 3000, 4000 et 4001. Turborepo surveille les fichiers .env*, donc le cache est invalidé lorsque ces variables changent.
Flux de développement
L'outillage comprend TypeScript pour le typage statique et Biome pour le linting et le formatage. Les commandes sont exécutées avec bun : `bun run build` et `bun run dev` construisent ou lancent tout, tandis que `--filter=www`, `--filter=ui` ou `--filter=origin` ciblent une seule application.
Ce que fournit coss ui
coss ui est présenté comme une collection de composants React accessibles et composables, construits sur Base UI et stylisés avec Tailwind CSS, conçus pour que les développeurs puissent copier, coller et posséder le code. Le README précise que les primitives non stylisées de Base UI reçoivent un système de design prêt à l'emploi, et que c'est la bibliothèque de composants que Cal.com prévoit d'adopter progressivement. Le développement se poursuit en open source.
Acquisition d'Origin UI
Le dépôt inclut les composants Origin UI en tant qu'instantané legacy : une collection basée sur Radix et de style shadcn qui reste utilisable mais avec un support et une maintenance limités. Le travail actif se concentre sur les nouveaux composants Particles construits sur les primitives de coss ui. Les contributions sont invitées via les directives dans apps/ui/CONTRIBUTING.md, couvrant les rapports de bugs, les fonctionnalités et la documentation.
Licences
Les licences sont mixtes. La licence par défaut du projet est AGPLv3.0, tandis que apps/origin/ et apps/ui/ restent sous leur licence MIT originale ; tous les autres répertoires relèvent de l'AGPLv3. Les détails se trouvent dans LICENSING.md.
Remerciements
Le README remercie Tailwind CSS pour le framework CSS utility-first, Base UI pour les primitives accessibles sous-jacentes aux composants, shadcn/ui pour avoir inspiré la philosophie de composants copier-coller, et Fumadocs pour le framework de documentation utilisé pour les composants.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.