Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[blog] Add post to introduce the Connect plugin #41763

Merged
merged 29 commits into from
Apr 15, 2024
Merged
Show file tree
Hide file tree
Changes from 19 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
c466dcd
add initial post draft
danilo-leal Apr 3, 2024
3197f5d
add links
danilo-leal Apr 3, 2024
e3d820d
change date and add card
danilo-leal Apr 3, 2024
0c6d1c3
add correct kit version & other links
danilo-leal Apr 3, 2024
0e8f9bc
iterating on the copywriting + add videos
danilo-leal Apr 3, 2024
6d0d229
Vale lint: non-breaking space
danilo-leal Apr 3, 2024
edccf71
Vale lint: remove trailing punctuation in heading
danilo-leal Apr 3, 2024
fd3fd85
fix tag (which doesn't have non-breaking space)
danilo-leal Apr 3, 2024
2401999
link, writing, and date updates
danilo-leal Apr 5, 2024
a4923c9
extra: little layout fix
danilo-leal Apr 5, 2024
2e9a103
update publish date
danilo-leal Apr 8, 2024
a4bc041
update publishing date
danilo-leal Apr 10, 2024
9829558
run CI checks again
danilo-leal Apr 10, 2024
520f2a7
rerun CI checks
danilo-leal Apr 10, 2024
db24bae
update publishing date
danilo-leal Apr 11, 2024
11071f2
Sam's review
danilo-leal Apr 12, 2024
693e592
editing and formatting
danilo-leal Apr 12, 2024
3667ac9
Merge branch 'next' into connect-beta-blog-post
danilo-leal Apr 12, 2024
92ecc77
slight rewording
danilo-leal Apr 12, 2024
810e655
Sam's latest review
danilo-leal Apr 15, 2024
b6f90d0
rerun CI checks
danilo-leal Apr 15, 2024
1b448eb
Merge branch 'next' into connect-beta-blog-post
danilo-leal Apr 15, 2024
bc65434
fix link
danilo-leal Apr 15, 2024
518bd2f
formatting + improve card image
danilo-leal Apr 15, 2024
7be5e7d
improve Storybook images
danilo-leal Apr 15, 2024
a58e9b8
ensure there's not contradicting info
danilo-leal Apr 15, 2024
371790b
fix hero's image dimensions and link
danilo-leal Apr 15, 2024
f57c079
remove link from the image
danilo-leal Apr 15, 2024
9b11678
test fixing the OG manual image link
danilo-leal Apr 15, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/lib/sourcing.ts
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ const ALLOWED_TAGS = [
'MUI X',
'MUI System',
'Toolpad',
'Connect',
];

export const getAllBlogPosts = () => {
Expand Down
7 changes: 7 additions & 0 deletions docs/pages/blog/introducing-connect.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
import * as React from 'react';
import TopLayoutBlog from 'docs/src/modules/components/TopLayoutBlog';
import { docs } from './introducing-connect.md?muiMarkdown';

export default function Page() {
return <TopLayoutBlog docs={docs} />;
}
59 changes: 59 additions & 0 deletions docs/pages/blog/introducing-connect.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: 'Introducing Connect: a Figma plugin that exports Material UI code'
description: Connect is a Figma plugin that lets you generate a theme from the Material UI for Figma Design Kit.
date: 2024-04-16T00:00:00.000Z
authors: ['danilo-leal', 'DavidCnoops']
tags: ['Connect', 'Material UI', 'Product']
card: true
---

Ever since we released the [Material UI Design Kit for Figma](/store/items/figma-react/), designers continuously expressed how much faster and more efficient their experience collaborating with developers would be if they could hand over production-ready code generated directly from the design software that nicely integrates with a codebase using Material UI.

Check warning on line 10 in docs/pages/blog/introducing-connect.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [Google.We] Try to avoid using first-person plural like 'we'. Raw Output: {"message": "[Google.We] Try to avoid using first-person plural like 'we'.", "location": {"path": "docs/pages/blog/introducing-connect.md", "range": {"start": {"line": 10, "column": 12}}}, "severity": "WARNING"}
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

That's why Connect was created!
We're happy to share that the beta version is [available now, for free on Figma](https://www.figma.com/community/plugin/1336346114713490235/connect).

Check warning on line 13 in docs/pages/blog/introducing-connect.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [Google.We] Try to avoid using first-person plural like 'We'. Raw Output: {"message": "[Google.We] Try to avoid using first-person plural like 'We'.", "location": {"path": "docs/pages/blog/introducing-connect.md", "range": {"start": {"line": 13, "column": 1}}}, "severity": "WARNING"}
Let's walkthough some of the available features.

Check warning on line 14 in docs/pages/blog/introducing-connect.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [Google.We] Try to avoid using first-person plural like 'Let's'. Raw Output: {"message": "[Google.We] Try to avoid using first-person plural like 'Let's'.", "location": {"path": "docs/pages/blog/introducing-connect.md", "range": {"start": {"line": 14, "column": 1}}}, "severity": "WARNING"}
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

## Theme customization

Figma's local variables significantly matured the use of design tokens, making it possible to mirror Material UI more closely.
Parting from version [v5.16.0 and later versions](https://github.com/mui/mui-design-kits/releases/tag/v5.16.0), Connect takes advantage of that to allow you to generate code for any available or created token using local variables.
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

<video preload="metadata" controls muted loop playsinline width="1584" height="1080">
  <source src="/static/blog/introducing-connect/theme-customization.mp4" type="video/mp4">
</video>

Visit the documentation to learn [how to insert the generated code into your theme file](/material-ui/design-resources/connect/#using-the-generated-theme/).

## Component customization

You can fully customize a component's appearance across multiple states in the Design Kit and then generate the corresponding theme code.
This is one of the most exciting features because it makes tweaking components incredibly fast and easier for designers!
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

<video preload="metadata" controls muted loop playsinline width="1584" height="1080">
  <source src="/static/blog/introducing-connect/custom-component.mp4" type="video/mp4">
</video>

:::warning
While in beta, not all components are supported yet.
We'll expand component coverage progressively in the coming months.

Check warning on line 38 in docs/pages/blog/introducing-connect.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [Google.We] Try to avoid using first-person plural like 'We'. Raw Output: {"message": "[Google.We] Try to avoid using first-person plural like 'We'.", "location": {"path": "docs/pages/blog/introducing-connect.md", "range": {"start": {"line": 38, "column": 1}}}, "severity": "WARNING"}
For now you can experiment with the Button and Switch.
:::

## Quick Storybook preview

The Connect plugin also bakes in an embedded Storybook preview panel so that you can conveniently play around with your changes and see how they interact with other props and states available in the component API.

<video preload="metadata" autoplay muted loop playsinline width="1584" height="1080">
  <source src="/static/blog/introducing-connect/storybook.mp4" type="video/mp4">
</video>

## Try Connect now

Get the beta version of Connect now, availble **for free** on the [Figma Community](https://www.figma.com/community/plugin/1336346114713490235/connect)!
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

There's still a lot to do, and we're looking forward to hearing from all of you [who requested this plugin years ago](https://github.com/mui/mui-design-kits/issues/10).

Check warning on line 54 in docs/pages/blog/introducing-connect.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [Google.We] Try to avoid using first-person plural like 'we'. Raw Output: {"message": "[Google.We] Try to avoid using first-person plural like 'we'.", "location": {"path": "docs/pages/blog/introducing-connect.md", "range": {"start": {"line": 54, "column": 32}}}, "severity": "WARNING"}

- Check out further documentation for [the Connect plugin](/material-ui/design-resources/connect/) and [the Material UI Design Kit](/material-ui/design-resources/material-ui-for-figma/).
- If you've got any feedback, we'd love to [hear from you](https://mui-connect.canny.io/feedback).

Check warning on line 57 in docs/pages/blog/introducing-connect.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [Google.We] Try to avoid using first-person plural like 'we'. Raw Output: {"message": "[Google.We] Try to avoid using first-person plural like 'we'.", "location": {"path": "docs/pages/blog/introducing-connect.md", "range": {"start": {"line": 57, "column": 31}}}, "severity": "WARNING"}

Happy designing! 👨‍🎨
15 changes: 13 additions & 2 deletions docs/pages/careers.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -467,15 +467,26 @@ export default function Careers() {
href={routeUrl}
noLinkStyle
variant="outlined"
sx={{ p: 2, width: '100%', flexGrow: 1 }}
sx={{
p: 2,
width: '100%',
flexGrow: 1,
display: 'flex',
flexDirection: 'column',
}}
>
<Typography variant="body2" fontWeight="bold" sx={{ mb: 0.5 }}>
{title}
</Typography>
<Typography variant="body2" color="text.secondary" sx={{ mb: 1 }}>
{description}
</Typography>
<Typography variant="body2" fontWeight="bold" color="primary">
<Typography
variant="body2"
fontWeight="bold"
color="primary"
sx={{ mt: 'auto' }}
>
Learn more{' '}
<KeyboardArrowRightRounded
fontSize="small"
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
5 changes: 5 additions & 0 deletions docs/src/modules/components/TopLayoutBlog.js
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,11 @@ export const authors = {
avatar: 'https://avatars.githubusercontent.com/u/16889233',
github: 'DiegoAndai',
},
DavidCnoops: {
name: 'David Cnoops',
avatar: 'https://avatars.githubusercontent.com/u/28001064',
github: 'DavidCnoops',
},
};

const classes = {
Expand Down
2 changes: 1 addition & 1 deletion packages/mui-docs/src/branding/brandingTheme.ts
Original file line number Diff line number Diff line change
Expand Up @@ -905,7 +905,7 @@ export function getThemedComponents(): ThemeOptions {
...(variant === 'outlined' &&
color === 'primary' && {
borderColor: (theme.vars || theme).palette.primary[100],
backgroundColor: (theme.vars || theme).palette.primary[50],
backgroundColor: alpha(theme.palette.primary[100], 0.2),
...theme.applyDarkStyles({
color: (theme.vars || theme).palette.primary[300],
borderColor: alpha(theme.palette.primary[500], 0.2),
Expand Down
Loading