The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
Clarify twenty-ui setup in the README (#26044)
Raphaël Bosi053d3907ba28
diff --git a/packages/twenty-ui/README.md b/packages/twenty-ui/README.mdindex aef6c1c2f6f..ea2b09f2d48 100644--- a/packages/twenty-ui/README.md+++ b/packages/twenty-ui/README.md@@ -6,19 +6,25 @@Twenty's open-source React UI component library: components, icons, and design tokens built on a zero-runtime, CSS-variable styling layer.+Read the [twenty-ui documentation](https://docs.twenty.com/ui/getting-started) for setup, theming, and component guides.+> **Alpha:** `twenty-ui` is still in alpha. Its version number follows the Twenty SDK release cycle. APIs and component behavior may change between releases.# Installation+For a standalone React application, install the library and its peer dependencies. React 19 is required.+```bash-npm install twenty-ui+npm install twenty-ui monaco-editor react@^19 react-dom@^19```-`react`, `react-dom`, and `monaco-editor` are peer dependencies (install them in your app). The `twenty-ui/primitives/input`, `twenty-ui/primitives/feedback`, and `twenty-ui/primitives/navigation` entry points reference `monaco-editor`.+Install `monaco-editor` even if you never render a code editor: the `twenty-ui/primitives/input`, `twenty-ui/primitives/feedback`, and `twenty-ui/primitives/navigation` entry points reference it, and bundlers fail to resolve it otherwise.++For Twenty apps, follow [Using Twenty UI components](https://docs.twenty.com/developers/extend/apps/layout/front-components#using-twenty-ui-components). The front component renderer supplies the workspace theme. Keep `twenty-ui`, `twenty-sdk`, and `twenty-client-sdk` on the same version.# Usage-Import the base styles once, pick a theme stylesheet, and wrap your app in `ThemeProvider`:+For a standalone React application, import the base styles once, pick a theme stylesheet, and wrap your app in `ThemeProvider`:```tsximport { ThemeProvider } from 'twenty-ui/theme-constants';@@ -34,10 +40,9 @@ export const App = () => ();```-Components are available from the root entry point or from a specific subpath for better tree-shaking:+Prefer the matching subpath for better tree-shaking. Imports from the `twenty-ui` root entry point are also supported.```tsx-import { Button } from 'twenty-ui';import { Button } from 'twenty-ui/primitives/input';```