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 15 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} />;
}
63 changes: 63 additions & 0 deletions docs/pages/blog/introducing-connect.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: 'Introducing Connect: a Figma plugin that exports Material UI code'
description: Connect is perfect for designing and developing using the Material UI React library and Design Kit.
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved
date: 2024-04-13T00:00:00.000Z
authors: ['danilo-leal', 'DavidCnoops']
tags: ['Connect', 'Material UI', 'Product']
card: true
---

A few years ago, we released the [Material UI Design Kit for Figma](/store/items/figma-react/).

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": 18}}}, "severity": "WARNING"}
Since then, many designers who use it expressed how much faster their process would be if they could hand over production-ready code generated directly from the design software to developers using the Material UI React library.

That's why Connect, a Figma plugin, was developed and it's now [available now in beta](https://www.figma.com/community/plugin/1336346114713490235/connect)! 🎉

Ultimately, the goal for the Design Kits is to increase the efficiency and speed of the entire team that is using Material UI, drawing designers and developers closer by facilitating the way new designs reach the codebase.
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

## Theme customization

Connect works from the [Design Kit's v5.16.0](https://github.com/mui/mui-design-kits/releases/tag/v5.16.0) up as that was when it started to support Figma's local variables.
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved
This feature has significantly matured the use of design tokens, which is something Material UI has been doing for a while with all of [its theming features](/material-ui/customization/theming/).
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved

That means you can use Connect to generate code for any customized local variable and style included in the Design Kit.

<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/). -->
<!-- I remove the comment from the line above once we publish the docs, otherwise this PR's checks will fail -->

## Component customization

You can also drastically change a component's appearance (in multiple states) in the Design Kit and generate the corresponding theme code.
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved
This is one of the most exciting features because it makes tweaking components incredibly fast!

<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 42 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": 42, "column": 1}}}, "severity": "WARNING"}
For now, you can play around with the Button, Switch, and Typography!
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved
:::

## Quick Storybook preview

On Figma, it's possible to see all states of a certain component but not necessarily interact with them.
danilo-leal marked this conversation as resolved.
Show resolved Hide resolved
That's why there's an embedded Storybook preview panel in Connect so that you can conveniently play around with your changes and also see how they interact with other props 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).
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 58 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": 58, "column": 32}}}, "severity": "WARNING"}

- Check out further documentation for the Connect plugin and the Material UI Design Kit (To-be-removed note: I'll add links here once the corresponding PR for their docs is merged).
- If you've got any feedback, we'd love to [hear from you here](https://mui-connect.canny.io/feedback).

Check warning on line 61 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": 61, "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
Loading