Skip to content

Commit 138c314

Browse files
Merge branch 'development' into 986495-dev-new
2 parents 41ea8ea + 60c7d65 commit 138c314

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+661
-636
lines changed

blazor/ai-assistview/ai-integrations/gemini-integration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Nuget\Install-Package Markdig
6161

6262
Modify the razor file to integrate the Gemini AI with the AI AssistView component.
6363

64-
* update your Gemini API key securely in the configuration:
64+
* Update your Gemini API key securely in the configuration:
6565

6666
```bash
6767

blazor/ai-coding-assistants/mcp-server.md

Lines changed: 32 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor
2424
Before using [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant), ensure you have:
2525

2626
* Required [node](https://nodejs.org/en/) version >= 18
27-
* A [compatible MCP client](https://modelcontextprotocol.io/clients) (VS Code with GitHub Copilot, [Syncfusion<sup style="font-size:70%">&reg;</sup> CodeStudio](https://www.syncfusion.com/code-studio/), etc.)
27+
* A [compatible MCP client](https://modelcontextprotocol.io/clients) (Visual Studio Code with GitHub Copilot, [Syncfusion<sup style="font-size:70%">&reg;</sup> CodeStudio](https://www.syncfusion.com/code-studio/), etc.)
2828
* An active Syncfusion<sup style="font-size:70%">&reg;</sup> license (any of the following):
2929
- [Commercial License](https://www.syncfusion.com/sales/unlimitedlicense)
3030
- [Free Community License](https://www.syncfusion.com/products/communitylicense)
@@ -72,7 +72,7 @@ Below are setup instructions for popular MCP clients:
7272
* Once installed, the server will appear in the User Installed Server list, and will be added to the **config.yaml** file.
7373
* The server is now ready for use in Code Studio. For more details, refer to the [Code Studio documentation](https://help.syncfusion.com/code-studio/reference/configure-properties/mcp/customservers#npm-server).
7474

75-
### VS Code (GitHub Copilot MCP)
75+
### Visual Studio Code (GitHub Copilot MCP)
7676

7777
* To configure an MCP server for a specific workspace, you can create a `.vscode/mcp.json` file in your workspace folder.
7878

@@ -98,7 +98,33 @@ Below are setup instructions for popular MCP clients:
9898

9999
* Confirm the server is active by checking for a message like: `SyncfusionBlazorAssistant is running...` in the output.
100100

101-
* For additional guidance, refer to the [VS Code documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_add-an-mcp-server).
101+
* For additional guidance, refer to the [Visual Studio Code documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_add-an-mcp-server).
102+
103+
### Visual Studio (GitHub Copilot MCP)
104+
105+
* To configure an MCP server for a specific workspace, you can create a `.vs/mcp.json` file in your workspace folder.
106+
107+
```json
108+
{
109+
"servers": {
110+
"syncfusion-blazor-assistant": {
111+
"type": "stdio",
112+
"command": "npx",
113+
"args": [
114+
"-y",
115+
"@syncfusion/blazor-assistant@latest"
116+
],
117+
"env": {
118+
"Syncfusion_API_Key": "YOUR_API_KEY"
119+
}
120+
}
121+
}
122+
}
123+
```
124+
125+
* After updating the mcp.json configuration, open the GitHub Copilot Chat window. Click the Ask arrow, then select Agent.
126+
* Select the [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant) from the tools section.
127+
* For more details, refer to the official [Visual Studio documentation](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022).
102128

103129
### Cursor
104130

@@ -148,7 +174,7 @@ For more details, refer to the [Cursor documentation](https://cursor.com/docs/co
148174
```
149175

150176
* Click OK and Apply.
151-
177+
152178
For further assistance, see the [JetBrains documentation](https://www.jetbrains.com/help/ai-assistant/mcp.html#connect-to-an-mcp-server).
153179

154180
> For more detailed information about configuring MCP servers in various clients, refer to the official documentations, e.g., [Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json)
@@ -165,7 +191,7 @@ To activate the SyncfusionBlazorAssistant MCP server:
165191
* '@ask_syncfusion_blazor'
166192
* 'ej2-blazor'
167193

168-
In VS Code, use `#SyncfusionBlazorAssistant` for direct invocation.
194+
In Visual Studio Code, use `#SyncfusionBlazorAssistant` for direct invocation.
169195

170196
2. Grant permission for the server to run (for the session, workspace, or always).
171197
3. For best results, start a new chat for each new topic to maintain clean context.
@@ -209,4 +235,4 @@ Product support is available through the following mediums.
209235

210236
## See also
211237

212-
* [Syncfusion Blazor Documentation](https://blazor.syncfusion.com/documentation)
238+
* [Syncfusion Blazor Documentation](https://blazor.syncfusion.com/documentation)

blazor/appearance/figma.md

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
11
---
22
layout: post
3-
title: Introduction to the Figma UI Kit in Blazor - Syncfusion
4-
description: Check out and learn about the introduction to the Figma UI Kit in the Syncfusion Blazor and more details.
3+
title: Figma UI kits for Syncfusion Blazor - Syncfusion
4+
description: Learn about Syncfusion’s Figma UI kits for Blazor, available for Material 3, Fluent, Tailwind, and Bootstrap 5 themes, and how to export design tokens.
55
platform: Blazor
6-
component: Common
6+
control: Common
77
documentation: ug
88
---
99

10-
# Figma UI Kits for Syncfusion&reg; Controls
10+
# Figma UI kits for Syncfusion® controls
1111

12-
Syncfusion<sup style="font-size:70%">&reg;</sup> offers [Figma UI kits](https://www.figma.com/@syncfusion) to facilitate effective collaboration between designers and developers. The Figma UI kits are available in four themes: [Material 3](https://www.figma.com/community/file/1385969023252455137/syncfusion-ui-kit-material-3-theme), [Fluent](https://www.figma.com/community/file/1385969120047188707/syncfusion-ui-kit-fluent-theme), [Tailwind](https://www.figma.com/community/file/1385969065626384098/syncfusion-ui-kit-tailwind-theme), and [Bootstrap 5](https://www.figma.com/community/file/1385968977953858272/syncfusion-ui-kit-bootstrap-5-theme). These kits match the themes used in Syncfusion<sup style="font-size:70%">&reg;</sup> controls.
12+
Syncfusion<sup style="font-size:70%">&reg;</sup> provides [Figma UI kits](https://www.figma.com/@syncfusion) to streamline collaboration between designers and developers. The kits match the themes used by Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor components and are available for [Material 3](https://www.figma.com/community/file/1454123774600129202/syncfusion-ui-kit-material-3-theme), [Fluent](https://www.figma.com/community/file/1385969120047188707/syncfusion-ui-kit-fluent-theme), [Tailwind](https://www.figma.com/community/file/1385969065626384098/syncfusion-ui-kit-tailwind-theme), and [Bootstrap 5](https://www.figma.com/community/file/1385968977953858272/syncfusion-ui-kit-bootstrap-5-theme).
1313

14-
The kits contain reusable design controls with various possible states and variants, along with detailed figures, measurements, and icons, representing the Syncfusion<sup style="font-size:70%">&reg;</sup> controls.
14+
Each kit contains reusable design controls with states and variants, along with detailed figures, measurements, and icons that represent Syncfusion<sup style="font-size:70%">&reg;</sup> controls.
1515

16-
![Material 3](./images/material3.png)
16+
![Preview of the Material 3 Figma UI kit](./images/material3.png)
1717

1818
## Advantages of UI kits
1919

20-
The Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kit offers the following key advantages:
21-
- The UI kit includes detailed information about Syncfusion<sup style="font-size:70%">&reg;</sup> controls, such as available control lists, their states, and variants. This facilitates a quick understanding of Syncfusion<sup style="font-size:70%">&reg;</sup> controls.
22-
- Design controls are developed using the [atomic design methodology](https://atomicdesign.bradfrost.com/chapter-2/), making customization straightforward and efficient.
23-
- Developers can seamlessly match Syncfusion<sup style="font-size:70%">&reg;</sup> controls with your design requirements, ensuring alignment and accuracy.
24-
- By using standardized controls and themes, the UI kit ensures consistency in your designs, maintaining a uniform look and feel across projects.
20+
The Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kits offer the following advantages:
21+
- Detailed information about controls, including lists, states, and variants, to quickly understand available options.
22+
- Design controls follow the [atomic design methodology](https://atomicdesign.bradfrost.com/chapter-2/), making customization straightforward.
23+
- Developers can match Syncfusion<sup style="font-size:70%">&reg;</sup> controls to design requirements for alignment and accuracy.
24+
- Standardized controls and themes maintain a consistent look and feel across projects.
2525

2626
## Downloading the UI kits
2727

28-
Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kits are available in the [Figma community](https://www.figma.com/@syncfusion). You can download the Syncfusion<sup style="font-size:70%">&reg;</sup> theme-specific Figma UI kits from the following links:
28+
The Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kits are available in the [Figma community](https://www.figma.com/@syncfusion). Download the theme-specific kits from the following links:
2929

3030
- [Material 3](https://www.figma.com/community/file/1454123774600129202/syncfusion-ui-kit-material-3-theme)
3131
- [Fluent](https://www.figma.com/community/file/1385969120047188707/syncfusion-ui-kit-fluent-theme)
@@ -34,7 +34,7 @@ Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kits are available in
3434

3535
## Structure of the UI kits
3636

37-
Syncfusion’s Figma UI kit is structured to offer a comprehensive and user-friendly layout, facilitating easy navigation and exploration of various controls. It includes the following pages:
37+
The Figma UI kits are structured for easy navigation and exploration of controls. They include the following pages:
3838

3939
- **Thumbnail**: This page serves as the cover page for the UI kit.
4040
- **Index**: Here, users can find a detailed list of all control names, making it simple to identify and locate specific controls within the UI kit.
@@ -45,57 +45,57 @@ Syncfusion’s Figma UI kit is structured to offer a comprehensive and user-frie
4545

4646
## Customizing the UI kits
4747

48-
The Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kits are easily customizable to meet your specific needs, allowing you to create unique designs and adjust colors to match your brand guidelines. The [atomic design methodology](https://atomicdesign.bradfrost.com/chapter-2/) used in developing these controls, your customizations will be seamlessly reflected across multiple controls and their variants.
48+
The Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI kits are customizable to meet specific needs, allowing unique designs and color adjustments to match brand guidelines. Because the controls are built using the [atomic design methodology](https://atomicdesign.bradfrost.com/chapter-2/), customizations will be seamlessly reflected across multiple controls and variants.
4949

5050
Here's how to customize the primary button color of the Material 3 theme within your layout:
5151

5252
1. Visit our [UI kits](#downloading-the-ui-kits) and choose your preferred theme, such as the Material 3 theme.
53-
2. Open the selected theme in the Figma web application by clicking the **Open in Figma** button.
54-
3. For the desktop application, click the **Import** button in the top-right corner of the page. Select the downloaded Syncfusion<sup style="font-size:70%">&reg;</sup> fig file you want to import and click the **Open** button.
53+
2. Open the selected theme in the Figma web application by clicking **Open in Figma**.
54+
3. For the desktop application, click **Import** in the top-right corner. Select the downloaded Syncfusion<sup style="font-size:70%">&reg;</sup> Figma file and click **Open**.
5555
4. Identify the button you wish to customize within your layout.
56-
5. On the right side of the Figma interface, find the color variable options listed. For example, the variable for a particular button color might be labeled as `$primary-bg-color`, derived from the primary color variable.
57-
6. To customize this primary button control color, click outside the button to see the **Local variables** option on the right side of the Figma interface. It contains the design token for the color variables. Click the **Local variables** option.
56+
5. On the right side of the Figma interface, locate the color variables. For example, a button color variable might be labeled `$primary-bg-color`, derived from the primary color variable.
57+
6. To customize the primary button color, click outside the button to reveal the **Local variables** panel. It contains the design tokens for color variables. Click **Local variables**.
5858
7. A popup will show the design token list. You can change the primary color using a color palette.
5959
8. Once you've selected the new color (e.g., pink) for the primary variable, the button's color pattern will be updated accordingly. You'll see the changes reflected in real-time within your design.
6060

61-
![Customization](./images/customize.png)
61+
![Customize a component primary color using local variables](./images/customize.png)
6262

6363
In addition to changing the button color, you can also customize other aspects like font, spacing, shadows, etc., of the UI controls:
6464

6565
Feel free to experiment with these customization options to create a design that perfectly matches your requirements.
6666

67-
## Downloading the customized styles
67+
## Download customized styles
6868

69-
Effortlessly download customized style changes as tokens and CSS variables using the `Syncfusion<sup style="font-size:70%">&reg;</sup> Design Tokens` plugin. This plugin bridges the gap between design and development by converting Figma design variables into Syncfusion<sup style="font-size:70%">&reg;</sup> tokens for direct use in your applications to ensure a smooth transition from design to implementation.
69+
Download customized style changes as tokens and CSS variables using the Syncfusion<sup style="font-size:70%">&reg;</sup> Design Tokens plugin. This plugin bridges the gap between design and development by converting Figma design variables into Syncfusion<sup style="font-size:70%">&reg;</sup> tokens for direct use in your applications to ensure a smooth transition from design to implementation.
7070

7171
### Exporting design tokens
7272

7373
Follow these steps to download the customized styles from the Figma UI Kit:
7474

7575
- First, open a [Syncfusion<sup style="font-size:70%">&reg;</sup> Figma UI Kit](https://www.figma.com/@syncfusion).
76-
- Navigate to the `Plugin & widgets` section in Figma and search for the `Syncfusion<sup style="font-size:70%">&reg;</sup> Design Tokens`.
77-
- Once found, run the plugin. A popup will appear with an `Export` button.
76+
- Navigate to the `Plugins and widgets` section in Figma and search for **Syncfusion<sup style="font-size:70%">&reg;</sup> Design Tokens**.
77+
- Run the plugin. A dialog appears with an `Export` button.
7878
- Click the `Export` button. This action will generate a zip file containing your design tokens.
7979
- Select a directory to save the exported files.
8080
- Extract the downloaded zip file to access its contents.
8181

8282
![export-design-tokens](./images/syncfusion-design-tokens.png)
8383

84-
### Utilizing design tokens
84+
### Use design tokens
8585

8686
The exported zip file includes the following files:
87-
- `css-variables.css`: The css-variables.css file contains CSS variables for both light and dark themes, directly derived from your Figma designs. You can easily import this file into your application alongside the component styles to reflect your custom designs.
88-
- `<theme-name>-tokens.json`: This file (e.g., material3-tokens.json) contains style variables and values in a JSON format compatible with [Theme Studio](./theme-studio). This file, prefixed with the corresponding theme name, can be [imported](./theme-studio#import-previously-changed-settings-into-the-theme-studio) into [Theme Studio](./theme-studio) for further customization. After processing in [Theme Studio](./theme-studio), you can [download](./theme-studio#download-the-customized-theme) the updated styles file and integrate it into your application, bringing your custom themes to life.
87+
- `css-variables.css`: Contains CSS variables for light and dark themes derived from the Figma design. Import this file alongside component styles to reflect custom designs.
88+
- `<theme-name>-tokens.json`: Contains style variables and values in a JSON format compatible with [Theme Studio](./theme-studio). This file, prefixed with the corresponding theme name, can be [imported](./theme-studio#import-previously-changed-settings-into-the-theme-studio) into [Theme Studio](./theme-studio) for further customization. After processing in [Theme Studio](./theme-studio), you can [download](./theme-studio#download-the-customized-theme) the updated styles file and integrate it into your application, bringing your custom themes to life.
8989

9090
This streamlined process ensures that your unique design vision, crafted in Figma, is accurately translated into your final application, maintaining consistency between design and implementation.
9191

92-
## Upgrading the UI kits
92+
## Upgrade the UI kits
9393

94-
To upgrade your UI kits, download the latest version from the provided links. Follow these guidelines for a seamless upgrade process:
94+
To upgrade the UI kits, download the latest versions from the links above. Follow these guidelines for a seamless upgrade:
9595

9696
- Keep track of updates or new versions of UI kits from Syncfusion.
9797
- Before upgrading, back up your ongoing projects to prevent data loss or compatibility issues.
98-
- Share your experience with Syncfusion<sup style="font-size:70%">&reg;</sup> regarding the upgraded UI kits, including any issues encountered or suggestions for improvement.
98+
- Share feedback regarding the upgraded UI kits, including any issues encountered or suggestions for improvement.
9999

100100
## See also
101101

0 commit comments

Comments
 (0)