~/vi/docs/ecosystem

Hệ sinh thái npm

Wakii đóng gói design system và bộ scaffold thành ba package npm công khai. Mọi thứ dưới đây đã live trên registry và được verify end-to-end.

@wakii/ui-kit — 0.7.1

Design system React đứng sau mọi mặt của Wakii: 113 component kiểu antd cho công việc admin/dashboard — Button (ripple + classNames slots), cả họ Input, Table, Tree, Form (InputOTP…), data display (Carousel, Avatar, Timeline, Statistic…), feedback (Alert, Message, Notification), overlay — kèm các engine nặng sau subpath: chart (chart.js), schedule (FullCalendar), editor (Tiptap) và Experience3D (three.js — Scene3D / ShipModel / ScrollFlythrough).

  • Theming — UiKitProvider dark/light + override accent qua data-bp-theme; CSS tokens cascade toàn cây.
  • Tùy biến — mọi component nhận classNames slots và style passthrough, override chạm tới từng phần mà không cần component bọc.
  • Peer deps giảm nội bộ — chart.js / swiper / tiptap / three / fullcalendar đều optional: thiếu engine thì fallback về node thường, không bao giờ crash.
  • 0.5.0 breaking — Carousel chuyển sang subpath @wakii/ui-kit/carousel.
npm install @wakii/ui-kit

Xem mọi component sống động: Storybook · npm

create-wakii-app — 0.2.4

npm create wakii-app@latest my-app

Starter React kiểu CRA với preset theo từng mặt — demo (mặc định), minimal, product (TanStack Query + zod + MSW), admin, landing — preset demo có biến thể vite, next (App Router) hoặc astro (React island). TypeScript hoặc JavaScript, react-router v7, demo route cho extras (chart / carousel / schedule / editor), dark toggle chạy thật, dogfood @wakii/ui-kit ^0.7.1. Đầy đủ flag non-interactive.

npm

create-wakii-stack — 0.1.11

npm create wakii-stack@latest my-stack

Scaffold trọn vẹn kiến trúc Wakii: chọn services qua manifest (Postgres, Kafka KRaft, auth-svc JWT, gateway nginx, node-svc / spring-svc / go-svc, MF shell + remote tasks & activity, admin) và CLI prune compose, lockfile, workspace theo đúng lựa chọn — docker compose up là stack chạy ngay sau cửa vào duy nhất gateway (:8080; README sinh kèm cảnh báo). Tarball chmod-safe. Các bản gần đây gia cố kafka-init chống race khi tạo topic, README sinh kèm tài khoản demo seeded. Đã verify end-to-end từ registry thật: register/login JWT, tasks CRUD, activity feed qua Kafka.

npm