@primereact/mcp 11.0.0 → 11.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/data/llms/headless/components/sidebar/api.json +1029 -54
  2. package/data/llms/headless/guides/misc/internationalization.md +282 -0
  3. package/data/llms/headless/guides/misc/locale.md +280 -0
  4. package/data/llms/llms-full.txt +9822 -1377
  5. package/data/llms/llms.txt +15 -0
  6. package/data/llms/primitive/components/sidebar/api.json +127 -33
  7. package/data/llms/primitive/guides/migration/updating-to-v11.md +2219 -0
  8. package/data/llms/primitive/guides/misc/internationalization.md +287 -0
  9. package/data/llms/primitive/guides/misc/locale.md +280 -0
  10. package/data/llms/styled/add-ons/designer/ci.md +273 -0
  11. package/data/llms/styled/add-ons/designer/guide.md +99 -0
  12. package/data/llms/styled/add-ons/designer/overview.md +194 -0
  13. package/data/llms/styled/add-ons/uikit/guide/v3.md +181 -0
  14. package/data/llms/styled/add-ons/uikit/guide/v4.md +163 -0
  15. package/data/llms/styled/add-ons/uikit/overview.md +204 -0
  16. package/data/llms/styled/components/datatable.md +8 -5
  17. package/data/llms/styled/components/menu.md +39 -41
  18. package/data/llms/styled/guides/configuration.md +198 -0
  19. package/data/llms/styled/guides/form/formik.md +448 -0
  20. package/data/llms/styled/guides/form/react-hook-form.md +503 -0
  21. package/data/llms/styled/guides/form/tanstack.md +502 -0
  22. package/data/llms/styled/guides/migration/updating-to-v11.md +2219 -0
  23. package/data/llms/styled/guides/misc/internationalization.md +379 -0
  24. package/data/llms/styled/guides/misc/locale.md +280 -0
  25. package/data/llms/tailwind/components/menu.md +5 -5
  26. package/data/llms/tailwind/components/tooltip.md +4 -13
  27. package/data/llms/tailwind/guides/misc/internationalization.md +287 -0
  28. package/data/llms/tailwind/guides/misc/locale.md +280 -0
  29. package/data/manifest.json +339 -24
  30. package/data/mcp-data.json +263 -8
  31. package/dist/index.js +1 -1
  32. package/package.json +1 -1
@@ -0,0 +1,181 @@
1
+ # PrimeOne Guide v3
2
+
3
+ PrimeOne is PrimeTek's official Figma UI Kit, built to work seamlessly with the Prime UI Suites.
4
+
5
+ > **Legacy Notice:** UI Kit v3 is deprecated due to its dependency on the Tokens Studio Plugin. We strongly recommend migrating to UI Kit v4, which uses native Figma variables for significantly improved performance and eliminates third-party dependencies.
6
+
7
+ ## Overview
8
+
9
+ PrimeOne is the official Figma library of UI components designed to match the implementations in the Prime UI Suites. The current iteration of PrimeOne is structured around the **Aura Light** and **Aura Dark** themes.
10
+
11
+ ## Resources
12
+
13
+ PrimeOne for Figma takes full advantage of powerful Figma features such as components, variants, auto layout, styles, interactivity, and design tokens via Tokens Studio.
14
+
15
+ If you're new to Figma or want to get the most out of PrimeOne, we recommend exploring the following resources:
16
+
17
+ - [Tokens Studio Documentation](https://docs.tokens.studio/) - PrimeOne uses Tokens Studio for design token management. Visit the official docs to understand how it works and how to use it effectively.
18
+ - [Figma's Best Practice Guides](https://www.figma.com/best-practices/) - Learn how to work efficiently with components, variants, and layouts.
19
+ - [Figma's Official YouTube Channel](https://www.youtube.com/figmadesign) - Tutorials and feature walkthroughs from the Figma team.
20
+ - [Figmalion Newsletter](https://figmalion.com/) - Stay updated with curated insights from the Figma community.
21
+
22
+ ## Installation
23
+
24
+ ### Importing
25
+
26
+ - **Download the latest .fig UI Kit** - From your PrimeStore panel, download the latest PrimeOne package. The archive contains the .fig UI Kit.
27
+ - **Open Figma in Google Chrome** - Launch Figma in Chrome (or another supported browser). Avoid using the Desktop app for this import. It's more reliable in-browser.
28
+ - **Import into your Team project** - Navigate to the Teams section in the left sidebar. Select your Team project where you want PrimeOne. Drag and drop the .fig file into the project folder in the browser UI. Figma will upload it, showing a new file card once complete.
29
+
30
+ ![Importing PrimeOne](https://primefaces.org/cdn/uikit/installation-1.png)
31
+
32
+ ### Publishing
33
+
34
+ To make PrimeOne available as a shared library:
35
+
36
+ - Open the imported PrimeOne .fig file.
37
+ - Go to **Assets → Manage Libraries**.
38
+ - Click **"Publish..."** to share PrimeOne with your team, then confirm by clicking the "Publish" button in the modal.
39
+
40
+ ![Publishing PrimeOne](https://primefaces.org/cdn/uikit/installation-2.png)
41
+
42
+ ### Enabling
43
+
44
+ If you want to enable PrimeOne across all files in your team, follow these steps:
45
+
46
+ - Navigate to **All Projects** from the Teams section.
47
+ - Go to **View Settings → View Team Libraries**. You can find this option in the dropdown menu next to your team name.
48
+ - Toggle PrimeOne "On" to make it available globally.
49
+
50
+ ![Enabling PrimeOne](https://primefaces.org/cdn/uikit/installation-3.png)
51
+
52
+ ## Suggested Workflow
53
+
54
+ PrimeOne uses Tokens Studio as its primary tool for design token management. To leverage the benefits of Figma Variables, these variables have also been exported from Tokens Studio and included in the file. This setup, while powerful, can make design changes somewhat complex and less fluid due to the way the tools interact. Although the provided guide outlines the recommended steps, we acknowledge that the workflow may feel unintuitive or slow at times. We're actively exploring improvements, and in the meantime, suggest following the guide as a baseline while adapting it to your team's needs where necessary.
55
+
56
+ ### Tokens Studio Setup
57
+
58
+ - **Set sync provider via Tokens Studio** - Figma plugins are limited to sharing a maximum of 100KB of data through their APIs. Because PrimeOne's token data exceeds this limit, using tokens locally within your Figma file may lead to performance issues. To avoid this, you should first configure and switch to a remote sync provider. You can follow the official [Tokens Studio guide](https://docs.tokens.studio/token-storage/remote) for setting up remote storage.
59
+ - **Push tokens to your sync provider** - Once you've successfully switched to your new sync provider, push the token data from your local file to the new provider to ensure everything stays in sync.
60
+ - **Set Base Font Size to `{app.font.size}` in Tokens Studio Settings** - PrimeOne uses a base font size of 14px, aligning with the default in Prime UI libraries. In Tokens Studio, go to the Settings tab and set the Base font size to `{app.font.size}`.
61
+ - If you wish to change this value, you can [update](https://docs.tokens.studio/manage-settings/base-font-size) the corresponding token in the app set.
62
+
63
+ ### CI Pipeline
64
+
65
+ Theme Designer offers an API that can be utilized to implement continuous integration pipelines to automate Figma to theme code generation whenever you push updates to the repository from Figma. Visit the [CI Pipeline](/docs/styled/add-ons/designer/ci) documentation for comprehensive information.
66
+
67
+ ### Design Changes
68
+
69
+ - **Change on Tokens Studio** - The first step when planning a design change is to identify which tokens need to be modified within Tokens Studio. Use the **Inspect** tab in Tokens Studio to locate the relevant tokens, then apply your changes directly via the plugin. After making the updates, don't forget to push the changes to your Sync Provider.
70
+ - **Change on Figma Variables** - After making changes in Tokens Studio, you also need to apply these updates in Figma Variables. There are two options:
71
+ - Manually update the variables one by one, or
72
+ - Use the **Export to Styles & Variables** feature in Tokens Studio.
73
+
74
+ In our own workflow, we prefer to update the variables manually, as the export feature can be unstable with large files like PrimeOne. We recommend this manual approach for reliability. However, if you choose to use the export feature, make sure the settings match the screenshot provided. Specifically, ensure the "**Themes (Pro)**" tab is selected during the second step. Don't worry, even though it says "Pro," you don't need a Pro license to access this feature in Tokens Studio. If you notice missing or incomplete exports on your first attempt, try running the export again from the beginning. This is a known issue with Tokens Studio and often resolves on the second attempt. For more detailed guidance, see the [official documentation](https://docs.tokens.studio/figma/export).
75
+
76
+ ![Design changes export settings](https://primefaces.org/cdn/uikit/designchanges-1.png)
77
+ - **Get Updates on Consumer Files** - We do not recommend making design changes directly in consumer files, as this goes against best practices. Instead, apply all design updates in the main UI Kit file, then publish the library and accept the updates in any consumer files that rely on it.
78
+
79
+ ## Token Sets
80
+
81
+ - **Primitive** - This set contains the most foundational tokens, such as base colors and border radius, elements that are considered "primitive" by nature.
82
+ - **Semantic** - Includes essential system-wide tokens like primary, surface, and other shared design values. It also defines tokens used across multiple component groups. For example, tokens under `{form.field.*}` are referenced by component-level tokens in InputText, MultiSelect, Checkbox, and other form components, enabling consistent styling across the board.
83
+ - **Component** - These tokens are defined specifically for each component to allow deep customization. While we've aimed to create dedicated tokens for every component state, many of them still reference the semantic or primitive tokens, allowing you to make global updates from a single place when needed.
84
+ - **App** - Tokens in this set are not part of the [PrimeUIX](https://github.com/primefaces/primeuix) system. They are intended for values defined in your own application. The same applies to tokens used in our UI library showcases. For example, there is no dedicated font size token in **PrimeUIX** because font styles are not part of the design system. UI components inherit their font settings from the application.
85
+ - **Custom** - If you're using the Figma to Theme feature and want your newly created custom tokens to appear in your Theme Designer themes, place them in this set. Even if you're not using the Theme Designer, we still recommend creating a separate set — or using the existing "Custom" set — for your own tokens. Making changes to the default sets, especially deleting tokens or altering reference values, can lead to inconsistencies with the library tokens and cause additional work during development.
86
+
87
+ ## Update PrimeOne
88
+
89
+ When a new version of PrimeOne is released, follow the steps below to update your files:
90
+
91
+ - Download the latest version of PrimeOne from PrimeStore.
92
+ - Unzip the file and upload it to your Figma workspace.
93
+ - Publish the newly uploaded file as a library.
94
+ - In all consumer files, use **Swap Library** to point to the new version.
95
+ - Once the transition is complete, you can safely unpublish the old PrimeOne library.
96
+
97
+ Before each update, it's a good idea to review the **Changelog** on the Get Started page of the PrimeOne Figma file.
98
+
99
+ Keep in mind that while Swap Library will update most components, any customized components may require manual review and adjustment.
100
+
101
+ ## Adding PrimeIcons
102
+
103
+ PrimeOne uses PrimeIcons, the official icon library by PrimeTek. To use it effectively within your design system, you need to add PrimeIcons to your Figma environment by following these steps:
104
+
105
+ - Open the [PrimeIcons](https://www.figma.com/community/file/1354343849355792252/primeicons) file in Figma and move it to your team project.
106
+
107
+ ![Adding PrimeIcons - step 1](https://primefaces.org/cdn/uikit/primeicons-1.png)
108
+
109
+ - Publish the PrimeIcons file and enable it for all team files in your Team Settings.
110
+
111
+ ![Adding PrimeIcons - step 2](https://primefaces.org/cdn/uikit/primeicons-2.png)
112
+
113
+ - Return to your PrimeOne file. In the Libraries panel, click on the banner that says "Includes X missing libraries."
114
+
115
+ ![Adding PrimeIcons - step 3](https://primefaces.org/cdn/uikit/primeicons-3.png)
116
+
117
+ - From the dropdown, select "**PrimeIcons (Community)**" and click the **Swap Library** button.
118
+
119
+ ![Adding PrimeIcons - step 4](https://primefaces.org/cdn/uikit/primeicons-4.png)
120
+
121
+ ## FAQ
122
+
123
+ ### Usage
124
+
125
+ **What should we do after purchasing? I can't publish the Preview file?**
126
+
127
+ The Preview file is **view-only**, so it can't be published. To use the library, download the .fig file from PrimeStore and import it into your Figma workspace. Once imported, you'll be able to open the file and publish it as a library for use in your projects.
128
+
129
+ **How to change theme?**
130
+
131
+ After exporting your tokens as Figma Variables using the Themes option in Tokens Studio, theme switching must be handled using Figma's native **Mode Switching** feature. The Theme Switcher within the Tokens Studio plugin will no longer function once themes are bound to a Variable Collection — this applies to PrimeOne as well. Therefore, to switch between Light and Dark modes, you should always use Figma's built-in Mode Switching interface.
132
+
133
+ ### Components
134
+
135
+ **How to change base font size?**
136
+
137
+ The base font size used in PrimeOne is 14px. Similar to how rem works in CSS, this is controlled by the `{app.font.size}` token located under the "app" set in Tokens Studio. When you change the value of this token, all size calculations will adjust accordingly based on the new value.
138
+
139
+ To apply this change, you need to use the "Apply" function in Tokens Studio. However, we do not recommend using the "**Apply to Document**" option if the change affects the entire library, as it may lead to unexpected errors. Instead, go page by page and review the updates carefully before applying changes.
140
+
141
+ Also note: not all token values in the library may be linked to `{app.font.size}`. So it's important to check components individually. After completing each page, verify the updated values under Local Variables and make manual adjustments if needed. Alternatively, you can use **Export Styles & Variables** to Figma in Tokens Studio to sync the updated values.
142
+
143
+ ### Tokens
144
+
145
+ **Is Tokens Studio too slow?**
146
+
147
+ This might be caused by using the wrong Apply method when pushing your changes. Since PrimeOne is a large file, using **Apply to Document** can result in very long processing times. We recommend using **Apply to Selection** or **Apply to Page** instead for better performance.
148
+
149
+ ### Updates
150
+
151
+ **Will there be a completely new Figma file with each update, or will the current PrimeOne file be modified and versioned?**
152
+
153
+ Each update will come as a new Figma file—an updated version of the previous one. You can seamlessly transition to the new version in your consumer files using Figma's **Swap Library** feature.
154
+
155
+ **Will the PrimeOne UI Kit stay in sync with ongoing updates to the Prime UI Libraries?**
156
+
157
+ The PrimeOne UI Kit does not update in real time alongside the libraries. However, we regularly release updates to bridge the gap and ensure alignment with key changes.
158
+
159
+ **How will users receive new components when they're added?**
160
+
161
+ New components will be included in future updates to the UI Kit. Please note that these updates may not coincide immediately with library changes and may take some time to roll out.
162
+
163
+ **How frequently is the PrimeOne UI Kit updated?**
164
+
165
+ We don't follow a fixed release schedule. Updates are made as needed, based on significant changes or additions to the Prime UI libraries.
166
+
167
+ ### Roadmap
168
+
169
+ **Are there plans to add a Tailwind theme to the UI Kit?**
170
+
171
+ At this time, we do not plan to include Tailwind theme support in the Figma UI Kit.
172
+
173
+ ### Licence
174
+
175
+ **Will purchasing a PrimeBlocks license include access to PrimeOne components?**
176
+
177
+ No. The PrimeBlocks license does not grant access to the PrimeOne UI Kit. They are separate products with individual licenses.
178
+
179
+ ## Support
180
+
181
+ The community gathers on [GitHub Discussions](https://github.com/orgs/primefaces/discussions/categories/figma-ui-kit) and [Discord](https://discord.gg/gzKFYnpmCY) to ask questions, share ideas, and discuss the technology. For direct inquiries or suggestions, feel free to contact us at [contact@primetek.com.tr](mailto:contact@primetek.com.tr).
@@ -0,0 +1,163 @@
1
+ # PrimeOne Guide
2
+
3
+ PrimeOne is a strong UI component library that gets even better with a great Figma UI Kit. It is PrimeTek's official Figma UI Kit, built to work seamlessly with the Prime UI Suites.
4
+
5
+ ## Overview
6
+
7
+ PrimeOne is the official Figma library of UI components designed to match the implementations in the Prime UI Suites. The current iteration of PrimeOne is structured around the **Aura Light** and **Aura Dark** themes.
8
+
9
+ ## Important Notice
10
+
11
+ Starting from PrimeOne UI Kit version 4.0, the Tokens Studio plugin is no longer used. We've fully migrated to Figma's native variable features, which now power the system. If you prefer to continue working with Tokens Studio, please use PrimeOne UI Kit version 3.2, which still supports the plugin.
12
+
13
+ ## Resources
14
+
15
+ PrimeOne for Figma takes full advantage of powerful Figma features such as components, variants, auto layout, styles, prototypes, and variables.
16
+
17
+ If you're new to Figma or want to get the most out of PrimeOne, we recommend exploring the following resources:
18
+
19
+ - [Variables](https://help.figma.com/hc/en-us/sections/14506605769879-Variables) - PrimeOne uses Figma Variables for design token management. Visit the official docs to understand how it works and how to use it effectively.
20
+ - [Figma's Best Practice Guides](https://www.figma.com/best-practices/) - Learn how to work efficiently with components, variants, and layouts.
21
+ - [Figma's Official YouTube Channel](https://www.youtube.com/figmadesign) - Tutorials and feature walkthroughs from the Figma team.
22
+ - [Figmalion Newsletter](https://figmalion.com/) - Stay updated with curated insights from the Figma community.
23
+
24
+ ## Installation
25
+
26
+ ### Importing
27
+
28
+ - **Download the latest .fig UI Kit** - From your PrimeStore panel, download the latest PrimeOne package. The archive contains the .fig UI Kit.
29
+ - **Open Figma in Google Chrome** - Launch Figma in Chrome (or another supported browser). Avoid using the Desktop app for this import. It's more reliable in-browser.
30
+ - **Import into your Team project** - Navigate to the Teams section in the left sidebar. Select your Team project where you want PrimeOne. Drag and drop the .fig file into the project folder in the browser UI. Figma will upload it, showing a new file card once complete.
31
+
32
+ ![Importing PrimeOne](https://primefaces.org/cdn/uikit/installation-1.png)
33
+
34
+ ### Publishing
35
+
36
+ To make PrimeOne available as a shared library:
37
+
38
+ - Open the imported PrimeOne .fig file.
39
+ - Go to **Assets → Manage Libraries**.
40
+ - Click **"Publish..."** to share PrimeOne with your team, then confirm by clicking the "Publish" button in the modal.
41
+
42
+ ![Publishing PrimeOne](https://primefaces.org/cdn/uikit/installation-2.png)
43
+
44
+ ### Enabling
45
+
46
+ If you want to enable PrimeOne across all files in your team, follow these steps:
47
+
48
+ - Navigate to **All Projects** from the Teams section.
49
+ - Go to **View Settings → View Team Libraries**. You can find this option in the dropdown menu next to your team name.
50
+ - Toggle PrimeOne "On" to make it available globally.
51
+
52
+ ![Enabling PrimeOne](https://primefaces.org/cdn/uikit/installation-3.png)
53
+
54
+ ## Collections
55
+
56
+ - **Primitive** — This collection contains the most foundational variables, such as base colors and border radius, elements that are considered "primitive" by nature.
57
+ - **Semantic Common & Semantic Color Scheme** — Includes essential system-wide variables like primary, surface, and other shared design values. It also defines variables used across multiple component groups. For example, variables under form/field are referenced by component-level variables in InputText, MultiSelect, Checkbox, and other form components, enabling consistent styling across the board.
58
+ - **Component Common & Component Color Scheme** — These variables are defined specifically for each component to allow deep customization. While we've aimed to create dedicated variables for every component state, many of them still reference the semantic or primitive variables, allowing you to make global updates from a single place when needed.
59
+ - **App** — Variables in this collection are not part of the [PrimeUIX](https://github.com/primefaces/primeuix) system. They are intended for values defined in your own application. The same applies to variables used in our UI library showcases. For example, there is no dedicated font size variable in **PrimeUIX** because font styles are not part of the design system. UI components inherit their font settings from the application.
60
+ - **Custom** — If you're using the Figma to Theme feature and want your newly created custom variables to appear in your Theme Designer themes, place them in this collection. Even if you're not using the Theme Designer, we still recommend creating a separate collection — or using the existing "Custom" collection — for your own variables. Making changes to the default collections, especially deleting variables or altering reference values, can lead to inconsistencies with the library variables and cause additional work during development.
61
+
62
+ ## PrimeUI Figma Plugin
63
+
64
+ PrimeUI Theme Generator Figma plugin is the official tool developed by PrimeTek that provides built-in synchronization capabilities to automate the theme code generation process. Visit the [plugin website](https://www.figma.com/community/plugin/1592914021886732603/primeui-theme-generator) to learn more about this workflow.
65
+
66
+ ## Update PrimeOne
67
+
68
+ When a new version of PrimeOne is released, follow the steps below to update your files:
69
+
70
+ - Download the latest version of PrimeOne from PrimeStore.
71
+ - Unzip the file and upload it to your Figma workspace.
72
+ - Publish the newly uploaded file as a library.
73
+ - In all consumer files, use **Swap Library** to point to the new version.
74
+ - Once the transition is complete, you can safely unpublish the old PrimeOne library.
75
+
76
+ Before each update, it's a good idea to review the **Changelog** on the Get Started page of the PrimeOne Figma file.
77
+
78
+ Keep in mind that while Swap Library will update most components, any customized components may require manual review and adjustment.
79
+
80
+ ## Adding PrimeIcons
81
+
82
+ PrimeOne uses PrimeIcons, the official icon library by PrimeTek. To use it effectively within your design system, you need to add PrimeIcons to your Figma environment by following these steps:
83
+
84
+ - Open the [PrimeIcons](https://www.figma.com/community/file/1354343849355792252/primeicons) file in Figma and move it to your team project.
85
+
86
+ ![Adding PrimeIcons - step 1](https://primefaces.org/cdn/uikit/primeicons-1.png)
87
+
88
+ - Publish the PrimeIcons file and enable it for all team files in your Team Settings.
89
+
90
+ ![Adding PrimeIcons - step 2](https://primefaces.org/cdn/uikit/primeicons-2.png)
91
+
92
+ - Return to your PrimeOne file. In the Libraries panel, click on the banner that says "Includes X missing libraries."
93
+
94
+ ![Adding PrimeIcons - step 3](https://primefaces.org/cdn/uikit/primeicons-3.png)
95
+
96
+ - From the dropdown, select "**PrimeIcons (Community)**" and click the **Swap Library** button.
97
+
98
+ ![Adding PrimeIcons - step 4](https://primefaces.org/cdn/uikit/primeicons-4.png)
99
+
100
+ ## FAQ
101
+
102
+ ### Usage
103
+
104
+ **What should we do after purchasing? I can't publish the Preview file?**
105
+
106
+ The Preview file is **view-only**, so it can't be published. To use the library, download the .fig file from PrimeStore and import it into your Figma workspace. Once imported, you'll be able to open the file and publish it as a library for use in your projects.
107
+
108
+ **How to change theme?**
109
+
110
+ To enable theme switching in PrimeOne, you need to set up the Variable modes. Select the layers you want to switch between Light or Dark. Then, under Appearance, use the Apply variable modes icon to assign both the Semantic and Component modes to the target theme.
111
+
112
+ ### Components
113
+
114
+ **How to change base font size?**
115
+
116
+ The base font size used in PrimeOne is 14px. Similar to how rem works in CSS, this is controlled by the scale/\* variables located under the "Primitive" collection in Variables.
117
+
118
+ When you change the values of these variables, all size calculations will adjust accordingly.
119
+
120
+ Note that not all variables in the library may be linked to scale/\* variables. So it's essential to check components individually.
121
+
122
+ ### Updates
123
+
124
+ **Will there be a completely new Figma file with each update, or will the current PrimeOne file be modified and versioned?**
125
+
126
+ Each update will come as a new Figma file—an updated version of the previous one. You can seamlessly transition to the new version in your consumer files using Figma's **Swap Library** feature.
127
+
128
+ **Will the PrimeOne UI Kit stay in sync with ongoing updates to the Prime UI Libraries?**
129
+
130
+ The PrimeOne UI Kit does not update in real time alongside the libraries. However, we regularly release updates to bridge the gap and ensure alignment with key changes.
131
+
132
+ **How will users receive new components when they're added?**
133
+
134
+ New components will be included in future updates to the UI Kit. Please note that these updates may not coincide immediately with library changes and may take some time to roll out.
135
+
136
+ **How frequently is the PrimeOne UI Kit updated?**
137
+
138
+ We don't follow a fixed release schedule. Updates are made as needed, based on significant changes or additions to the Prime UI libraries.
139
+
140
+ ### Roadmap
141
+
142
+ **Are there plans to add a Tailwind theme to the UI Kit?**
143
+
144
+ At this time, we do not plan to include Tailwind theme support in the Figma UI Kit.
145
+
146
+ ### Licence
147
+
148
+ **Will purchasing a PrimeBlocks license include access to PrimeOne components?**
149
+
150
+ No. The PrimeBlocks license does not grant access to the PrimeOne UI Kit. They are separate products with individual licenses.
151
+
152
+ ## Limitations
153
+
154
+ Current known technical limitations are listed at this section.
155
+
156
+ - **Multiple-value variables** - Figma currently supports only a single value per variable. For this reason, multi-value tokens defined in PrimeUIX—such as padding or margin, which can contain multiple values—are represented in Figma as separate variables for each side (top/right/bottom/left) or axis (x/y), unlike the combined multi-value CSS definitions in PrimeUIX.
157
+ - **Calculations** - Since Figma does not yet allow calculations within variable definitions, values that rely on expressions like calc() cannot function dynamically. In these cases, any adjustments you make may require manual updates.
158
+ - **Focus Rings** - In Tokens Studio, focus rings could be positioned by calculating the outer stroke distance using expressions such as focus.ring.width + focus.ring.offset. Since Figma Variables do not support arithmetic operations, these calculations cannot be reproduced. As a result, focus ring width values are no longer dynamically linked and must be handled as static values.
159
+ - **Color Mix** - Figma Variables do not currently support color mix modifiers. Values in PrimeUIX that rely on color mixing have therefore been converted into raw hex values when brought into Figma Variables.
160
+
161
+ ## Support
162
+
163
+ The community gathers on [GitHub Discussions](https://github.com/orgs/primefaces/discussions/categories/figma-ui-kit) and [Discord](https://discord.gg/gzKFYnpmCY) to ask questions, share ideas, and discuss the technology. For direct inquiries or suggestions, feel free to contact us at [contact@primetek.com.tr](mailto:contact@primetek.com.tr).
@@ -0,0 +1,204 @@
1
+ # UI Kit
2
+
3
+ PrimeOne is PrimeTek's official Figma UI Kit, designed to match the implementations in the Prime UI Suites.
4
+
5
+ <img src="https://fqjltiegiezfetthbags.supabase.co/storage/v1/object/public/common.images/uikit/primeone-cover-light.jpg" alt="PrimeOne Figma UI Kit" className="w-full rounded-[50px] mb-8!" />
6
+
7
+ <div className="card rounded-[50px]! p-8! md:p-12! mb-8!">
8
+ <div className="flex flex-col gap-20">
9
+ <div className="flex flex-col md:flex-row items-center gap-6 md:gap-20">
10
+ <div className="w-full md:w-1/2">
11
+ <img src="https://fqjltiegiezfetthbags.supabase.co/storage/v1/object/public/common.images/uikit/uikit-figma.png" alt="Best Features of Figma" className="w-full rounded-xl mb-0!" />
12
+ </div>
13
+ <div className="w-full md:w-1/2">
14
+ <div className="text-primary font-bold mb-2">UP-TO-DATE</div>
15
+ <div className="text-5xl font-bold text-surface-900 dark:text-surface-0 mb-4">Best Features of Figma</div>
16
+ <p className="text-lg text-surface-600 dark:text-surface-300 mb-4">PrimeOne for Figma uses the latest powerful features like components, variants, auto layout, styles, variables and interactive components. It'll always follow the best practices.</p>
17
+ <div className="flex flex-wrap text-lg mt-4">
18
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Auto Layout</span></div>
19
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Variants</span></div>
20
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Variables and Styles</span></div>
21
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Interactive Components</span></div>
22
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Boolean, Instance Swap & Text</span></div>
23
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Nested Instances</span></div>
24
+ </div>
25
+ </div>
26
+ </div>
27
+ <div className="flex flex-col md:flex-row-reverse items-center gap-6 md:gap-20">
28
+ <div className="w-full md:w-1/2">
29
+ <img src="https://fqjltiegiezfetthbags.supabase.co/storage/v1/object/public/common.images/uikit/uikit-system.png" alt="Powerful System" className="w-full rounded-xl mb-0!" />
30
+ </div>
31
+ <div className="w-full md:w-1/2">
32
+ <div className="text-primary font-bold mb-2">ENTERPRISE GRADE</div>
33
+ <div className="text-5xl font-bold text-surface-900 dark:text-surface-0 mb-4">Powerful System</div>
34
+ <p className="text-lg text-surface-600 dark:text-surface-300 mb-4">Save countless hours on every project with a carefully designed system that uses Prime UI Suite components. Start producing design results in no time.</p>
35
+ <div className="flex flex-wrap text-lg mt-4">
36
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Numerous Components</span></div>
37
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Icon Library</span></div>
38
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Easy Customization</span></div>
39
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Atomic Approach</span></div>
40
+ </div>
41
+ </div>
42
+ </div>
43
+ <div className="flex flex-col md:flex-row items-center gap-6 md:gap-20">
44
+ <div className="w-full md:w-1/2">
45
+ <img src="https://fqjltiegiezfetthbags.supabase.co/storage/v1/object/public/common.images/uikit/uikit-themes.png" alt="Two Themes" className="w-full rounded-xl mb-0!" />
46
+ </div>
47
+ <div className="w-full md:w-1/2">
48
+ <div className="text-primary font-bold mb-2">DARK MODE</div>
49
+ <div className="text-5xl font-bold text-surface-900 dark:text-surface-0 mb-4">Two Themes</div>
50
+ <p className="text-lg text-surface-600 dark:text-surface-300 mb-4">PrimeOne is designed based on Aura Light and Aura Dark themes. Easily change the themes of your designs using Figma's native variable modes.</p>
51
+ <div className="flex flex-wrap text-lg mt-4">
52
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Aura Light</span></div>
53
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Aura Dark</span></div>
54
+ </div>
55
+ </div>
56
+ </div>
57
+ <div className="flex flex-col md:flex-row-reverse items-center gap-6 md:gap-20">
58
+ <div className="w-full md:w-1/2">
59
+ <img src="https://fqjltiegiezfetthbags.supabase.co/storage/v1/object/public/common.images/uikit/uikit-tokens.png" alt="Variables Support" className="w-full rounded-xl mb-0!" />
60
+ </div>
61
+ <div className="w-full md:w-1/2">
62
+ <div className="text-primary font-bold mb-2">VARIABLE MANAGEMENT</div>
63
+ <div className="text-5xl font-bold text-surface-900 dark:text-surface-0 mb-4">Variables Support</div>
64
+ <p className="text-lg text-surface-600 dark:text-surface-300 mb-4">Native Figma Variables unlock a whole new level of flexibility, allowing you to create, manage, and apply design tokens seamlessly—without relying on external plugins.</p>
65
+ <div className="flex flex-wrap text-lg mt-4">
66
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Countless Variables</span></div>
67
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Light and Dark Modes</span></div>
68
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Well Documented</span></div>
69
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Primitive, Semantic & Component</span></div>
70
+ </div>
71
+ </div>
72
+ </div>
73
+ <div className="flex flex-col md:flex-row items-center gap-6 md:gap-20">
74
+ <div className="w-full md:w-1/2">
75
+ <img src="https://fqjltiegiezfetthbags.supabase.co/storage/v1/object/public/common.images/designer/feature-2.png" alt="Figma to Theme Code" className="w-full rounded-xl mb-0!" />
76
+ </div>
77
+ <div className="w-full md:w-1/2">
78
+ <div className="text-primary font-bold mb-2">AUTOMATED</div>
79
+ <div className="text-5xl font-bold text-surface-900 dark:text-surface-0 mb-4">Figma to Theme Code</div>
80
+ <p className="text-surface-500 dark:text-surface-400 text-sm italic">This feature requires a <a href="/docs/styled/add-ons/designer/overview">Theme Designer</a> subscription.</p>
81
+ <p className="text-lg text-surface-600 dark:text-surface-300 mb-4">Sync design tokens from Figma to theme code with ease. Export token.json to the Visual Editor or generate and sync themes directly to your repository via the Figma plugin.</p>
82
+ <div className="flex flex-wrap text-lg mt-4">
83
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Automatic Mapping</span></div>
84
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Eliminate Handoff</span></div>
85
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">CI Pipeline</span></div>
86
+ <div className="flex items-center w-1/2 p-4"><i className="pi pi-check-circle text-green-600 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Live Preview</span></div>
87
+ </div>
88
+ </div>
89
+ </div>
90
+ </div>
91
+ </div>
92
+
93
+ <a href="https://www.figma.com/design/iKOqMjb5gBhqMQ0bZyzD0Y/Preview-%7C-PrimeOne-%7C-4.0.0?node-id=806-36648" target="_blank" rel="noopener noreferrer" className="flex flex-col md:flex-row items-center justify-center gap-8 p-12 mb-8 rounded-[50px] bg-linear-to-br from-blue-50 to-purple-50 dark:from-blue-950 dark:to-purple-950 border-2 border-transparent hover:border-primary transition-colors duration-300 no-underline! hover:no-underline!">
94
+ <div className="flex flex-col items-center md:items-start text-center md:text-left">
95
+ <span className="text-primary font-semibold text-sm uppercase tracking-wider mb-2">Figma UI Kit</span>
96
+ <span className="text-surface-900 dark:text-surface-0 text-5xl md:text-6xl font-bold mb-3">Preview</span>
97
+ <p className="text-surface-600 dark:text-surface-300 text-lg max-w-2xl mb-0!">Explore our complete design system with all components, variants, and interactive elements in Figma</p>
98
+ </div>
99
+ <div className="flex items-center justify-center shrink-0">
100
+ <svg width="80" height="80" viewBox="0 0 200 300" xmlns="http://www.w3.org/2000/svg">
101
+ <path d="M50 300c27.6 0 50-22.4 50-50v-50H50c-27.6 0-50 22.4-50 50s22.4 50 50 50z" fill="#0acf83" />
102
+ <path d="M0 150c0-27.6 22.4-50 50-50h50v100H50c-27.6 0-50-22.4-50-50z" fill="#a259ff" />
103
+ <path d="M0 50C0 22.4 22.4 0 50 0h50v100H50C22.4 100 0 77.6 0 50z" fill="#f24e1e" />
104
+ <path d="M100 0h50c27.6 0 50 22.4 50 50s-22.4 50-50 50h-50V0z" fill="#ff7262" />
105
+ <path d="M200 150c0 27.6-22.4 50-50 50s-50-22.4-50-50 22.4-50 50-50 50 22.4 50 50z" fill="#1abcfe" />
106
+ </svg>
107
+ </div>
108
+ </a>
109
+
110
+ <div className="card rounded-[50px]! p-8! md:p-12! mb-8!">
111
+ <div className="text-5xl font-bold text-center text-surface-900 dark:text-surface-0 mb-2">Pricing</div>
112
+ <div className="text-center text-lg text-surface-600 dark:text-surface-300 mb-8">Choose the right plan for your business. <a href="https://www.primefaces.org/uikit/licenses">View License Details</a>.</div>
113
+ <div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
114
+ <div className="flex flex-col shadow rounded-md p-8 bg-surface-0 dark:bg-surface-900">
115
+ <div className="text-xl font-medium text-surface-900 dark:text-surface-0 mb-2">Single Designer</div>
116
+ <div className="text-surface-500 dark:text-surface-400 font-medium">For individual designers</div>
117
+ <div className="border-t border-surface-200 dark:border-surface-700 my-4" />
118
+ <div className="text-2xl font-bold text-surface-900 dark:text-surface-0">$249</div>
119
+ <div className="border-t border-surface-200 dark:border-surface-700 my-4" />
120
+ <div className="flex flex-col grow text-lg">
121
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">1 Designer</span></div>
122
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Auto Layout & Variants</span></div>
123
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Interactive Components</span></div>
124
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Variables Support</span></div>
125
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">1 Year Free Updates</span></div>
126
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Use on Unlimited Projects</span></div>
127
+ </div>
128
+ <div className="border-t border-surface-200 dark:border-surface-700 mb-4 mt-auto" />
129
+ <a href="https://primeui.store/uikit" className="bg-blue-500 text-white hover:bg-blue-400 p-4 w-full rounded text-center font-bold no-underline! hover:no-underline! transition-colors">Buy Now</a>
130
+ </div>
131
+ <div className="flex flex-col shadow rounded-md p-8 bg-surface-0 dark:bg-surface-900">
132
+ <div className="text-xl font-medium text-surface-900 dark:text-surface-0 mb-2">Team</div>
133
+ <div className="text-surface-500 dark:text-surface-400 font-medium">For small teams</div>
134
+ <div className="border-t border-surface-200 dark:border-surface-700 my-4" />
135
+ <div className="text-2xl font-bold text-surface-900 dark:text-surface-0">$990</div>
136
+ <div className="border-t border-surface-200 dark:border-surface-700 my-4" />
137
+ <div className="flex flex-col grow text-lg">
138
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Up to 5 Designers</span></div>
139
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Auto Layout & Variants</span></div>
140
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Interactive Components</span></div>
141
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Variables Support</span></div>
142
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">1 Year Free Updates</span></div>
143
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Use on Unlimited Projects</span></div>
144
+ </div>
145
+ <div className="border-t border-surface-200 dark:border-surface-700 mb-4 mt-auto" />
146
+ <a href="https://primeui.store/uikit" className="bg-purple-500 text-white hover:bg-purple-400 p-4 w-full rounded text-center font-bold no-underline! hover:no-underline! transition-colors">Buy Now</a>
147
+ </div>
148
+ <div className="flex flex-col shadow rounded-md p-8 bg-surface-0 dark:bg-surface-900">
149
+ <div className="text-xl font-medium text-surface-900 dark:text-surface-0 mb-2">Enterprise</div>
150
+ <div className="text-surface-500 dark:text-surface-400 font-medium">For large teams</div>
151
+ <div className="border-t border-surface-200 dark:border-surface-700 my-4" />
152
+ <div className="text-2xl font-bold text-surface-900 dark:text-surface-0">Exclusive Deals</div>
153
+ <div className="border-t border-surface-200 dark:border-surface-700 my-4" />
154
+ <div className="flex flex-col grow text-lg">
155
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="font-bold text-surface-800 dark:text-surface-100">Custom Team Size</span></div>
156
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Auto Layout & Variants</span></div>
157
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Interactive Components</span></div>
158
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Variables Support</span></div>
159
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">1 Year Free Updates</span></div>
160
+ <div className="flex items-center mb-4"><i className="pi pi-check-circle text-green-500 mr-2" /><span className="text-surface-700 dark:text-surface-200">Use on Unlimited Projects</span></div>
161
+ </div>
162
+ <div className="border-t border-surface-200 dark:border-surface-700 mb-4 mt-auto" />
163
+ <a href="mailto:contact@primetek.com.tr" className="bg-gray-500 text-white hover:bg-gray-400 p-4 w-full rounded text-center font-bold no-underline! hover:no-underline! transition-colors">Contact Us</a>
164
+ </div>
165
+ </div>
166
+ </div>
167
+
168
+ <div className="card rounded-[50px]! p-8! md:p-12! mb-8!">
169
+ <div className="text-5xl font-bold text-center text-surface-900 dark:text-surface-0 mb-8">Frequently Asked Questions</div>
170
+ <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-x-8 gap-y-6">
171
+ <div>
172
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">What do I get when I purchase a license?</div>
173
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">You'll be able to download the Figma file of PrimeOne UI Kit.</p>
174
+ </div>
175
+ <div>
176
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">Is there a recurring fee or is the license perpetual?</div>
177
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">UI Kit license is perpetual so requires one time payment with 1 year free updates, not subscription based.</p>
178
+ </div>
179
+ <div>
180
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">Can I use UI Kit license for commercial projects?</div>
181
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">Yes, your license allows you to sell your projects that utilize the UI Kit implementations.</p>
182
+ </div>
183
+ <div>
184
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">Can I create multiple projects for multiple clients?</div>
185
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">There is no limit, you are able to use UI Kit in multiple projects for multiple clients.</p>
186
+ </div>
187
+ <div>
188
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">What does "Free Updates" mean?</div>
189
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">All updates are completely free for the first year after your purchase. After this period, you keep access to every version released within that first year indefinitely.</p>
190
+ </div>
191
+ <div>
192
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">How can I extend my access to updates?</div>
193
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">At PrimeStore, you have the option to purchase an additional update term for another year.</p>
194
+ </div>
195
+ <div>
196
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">Can I include UI Kit in an open source project?</div>
197
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">Due to the license, it is not possible to use the UI Kit in an open source project where the design files are publicly available.</p>
198
+ </div>
199
+ <div>
200
+ <div className="font-bold text-surface-900 dark:text-surface-0 mb-2">How can I get support?</div>
201
+ <p className="text-surface-600 dark:text-surface-300 mb-0! leading-normal">Seek assistance in our community via our public <a href="https://discord.com/invite/gzKFYnpmCY">Discord</a> and <a href="https://github.com/orgs/primefaces/discussions/categories/figma-ui-kit">Forum</a>.</p>
202
+ </div>
203
+ </div>
204
+ </div>