Seamlessly Transform Designs Into React Components with Our WorkflowSeamlessly Transform Designs Into React Components with Our Workflow
The network for creativity
Join 1.25M professional creatives like you
Connect with clients, get discovered, and run your business 100% commission-free
Creatives on Contra have earned over $150M and we are just getting started
My solution is about closing the gap between design and code with designing real, fully working components.
I designed a Contra-inspired profile card in Paper, then built a workflow that turns it into real, working React components.
The workflow in 3 steps:
→ Creating a contra.com style guide inside Paper, then asking it to create a copy of the profile card. Then making some refinement using the canvas and the design tools (I even added some new functionalities to the card, e.g. the fun fact section)
→ Paper design → component spec. My Claude skill reads the Paper file, including component states and the written explanations you might attached to your design, and writes a structured markdown specification with a component tree and these specs: appearance, user interactions, states, required input data.
→ Spec → working components. A second Claude skill generates real React components in Storybook and verifies each one against the Paper design until it matches: typography, colors, spacing, states.
(Btw. Storybook is a living catalog of your product's UI components, where each one runs in the browser as a real, interactive preview, so designers can click through every state and variation exactly as users will experience it, without waiting for the full app to be built around it.)
If you don’t design something, someone else (an AI, a developer) will. (It’s not necessarily a bad thing, but you need to be deliberate about what parts you want to outsource.)
With this workflow, you get to review and complete your design at two points:
→ first, when you get the detailed specification: you can take a quick look at it and fill in the gaps if needed
→ second, when you can play around with the live, fully coded components inside Storybook. You can also run tests to check e.g. whether the component is accessible or not.
With these two review steps built in, you can be sure that your design intent truly gets translated to code.
You can modify the spec, tweak the design in Paper, regenerate the components, and iterate until the result matches what you actually had in mind. No more redlining screenshots or re-explaining hover states in Slack.
Tools: Paper, Claude Code, Storybook, React. MCP Servers: Paper, Storybook, Chrome DevTools
(Btw. I also created the slide deck inside Paper using Claude from VS Code)
I'll be open-sourcing both Claude skills and the full workflow in the coming days, so you can use it in your own projects and start closing the gap between design and code the same way. Stay tuned! Thanks for the challenge @Stephen Haney @Contra HQ
Gergely's avatar
2. Then, I added some notes on Paper's canvas to specify how the components behave, what their states are.
Post image
Gergely's avatar

linkedin.com

#paperchallenge #contra #paper #claude #claudeskills #storybook | Gergely Szerovay

Closing the gap between design and code with designing real, fully working components with a workflow you can also add to your design process: here is my entry for the Contra × Paper challenge. I designed a Contra-inspired profile card in Paper, then built a workflow that turns it into real, fully working React components. The workflow in 3 steps: → Creating a contra.com style guide inside Paper, then asking it to create a copy of the profile card. Then making some refinement using the canvas and the design tools (I even added some new functionalities to the card, e.g. the fun fact section, the bookmark icon button and the share icon button) → Paper design → component spec. My Claude skill reads the Paper file, including component states and the written explanations you might attached to your design, and writes a structured markdown specification with a component tree and these specs: appearance, user interactions, states, required input data. → Spec → working components. A second Claude skill generates real React components in Storybook and verifies each one against the Paper design until it matches: typography, colors, spacing, states. (Btw. Storybook is a living catalog of your product’s UI components, where each one runs in the browser as a real, interactive preview, so designers can click through every state and variation exactly as users will experience it.) Why is this useful for you? If you don’t design something, someone else (an AI, a developer) will. (It’s not necessarily a bad thing, but you need to be deliberate about what parts you want to outsource.) With my workflow, you get to review and complete your design at two points: → first, when you get the detailed specification: you can take a quick look at it and fill in the gaps if needed. → second, when you can play around with the live, fully coded components inside Storybook. You can also run tests to check e.g. whether the component is accessible or not. With these two review steps built in, you can be sure that your design intent truly gets translated to code. You can modify the spec, tweak the design in Paper, regenerate the components, and iterate until the result matches what you actually had in mind. No more redlining screenshots or re-explaining hover states in Slack. Tools: Paper, Claude Code, Storybook, React. MCP Servers: Paper, Storybook, Chrome DevTools (Btw. I also created the slide deck you see in the video inside Paper using Claude from VS Code) I’ll be open-sourcing both Claude skills and the full workflow in the coming days, so you can use it in your own projects and start closing the gap between design and code the same way. Stay tuned! Thanks for the challenge Stephen Haney Vlad Moroz Agustín Seguí and Contra And thanks to Michael Riddering for bringing my attention to Paper 1.5 month ago. #paperchallenge #contra #paper #claude #claudeskills #storybook Check out my post on Contra: https://lnkd.in/e9maeZhg

Gergely's avatar
Here are some screenshots from Paper: 1. This is the Contra profile card - I created it by generating a Contra style guide inside Paper, then made some tweaks using Paper's design tools, and I also added some new parts just for fun
Post image
Gergely's avatar
3. Claude generated the Component States on a separate artboard inside Paper based on the written notes I added on the canvas in the previous step.
Post image
Gergely's avatar
4. The first Claude skill generated the component tree and a detailed component specification as a markdown file. I asked Claude to render this file inside Paper. (This is the first review step: you can check if something is missing or needs modification).
Post image
Gergely's avatar
5. The second skill generates React components based on the design inside Paper and based on the specification markdown file (previous step), then showcases them in Storybook. These are fully working React components: you can check out the user interactions, change the data displayed and run tests.
Post image
Gergely's avatar
Finally, I did not cover this in the video, but after all these steps, you can start a new iteration: you modify the design inside Paper or you modify the specification (the md file), and then you can ask Claude to modify the React components accordingly (or regenerate them using the second skill).
Back to feed
The network for creativity
Join 1.25M professional creatives like you
Connect with clients, get discovered, and run your business 100% commission-free
Creatives on Contra have earned over $150M and we are just getting started