Skip to content

makamekm/figma-react

Repository files navigation

React - Figma

This is a tool to help you export Figma project into React mockups

Installation

npm i -g figma-react

CLI Usage

figma-react <file-key> [figma-dev-token] <preset-name>

or you can provide .env file with the content

FIGMA_FILE_KEY=...
FIGMA_DEV_TOKEN=...
FIGMA_PRESET=...

Example with MobX & Gatsby

Run in your terminal the following code, but replace <figma-dev-token> with your Figma Dev Token (You can generate it on your profile settings page)

npm i -g gatsby-cli figma-react
gatsby new figma-demo https://github.com/makamekm/gatsby-starter-typescript-ioc-mobx
cd figma-demo
figma-react InZsgUaqMorH2q5iapfUDK <figma-dev-token> mobx
npm run dev

Then just put into pages/index.tsx the following code and import dependencies:

  <div style={{ height: '300px' }}>
    <ChromeMockup />
  </div>
  <Helmet>
    <link href="https://fonts.googleapis.com/css?family=Roboto&display=swap" rel="stylesheet" />
  </Helmet>

API Usage

const figmaReact = require('./figma');

figmaReact.runFigmaReact(options).catch(err => {
	console.error(err);
	console.error(err.stack);
	process.exit(1);
});

Requirements

  • Style JSX

Features

  • Customizable Style Plugins
  • Customizable Content Plugins
  • CLI tool
  • Can read .env properties

Options

  • fileKey // * required
  • devToken // * required
  • dir // default './src/design-system'
  • makeDir // default !!process.env.FIGMA_MAKE_DIR
  • stylePlugins // default from './figma.style.plugins'
  • contentPlugins // default from './figma.content.plugins'
  • classPrefix // default 'figma-'
  • delIndex // default '??'
  • paramsSplitIndex // default '&'
  • paramSplitIndex // default '='
  • objectIndex // default '.'
  • styleDescriptionDelimiter // default '!style!'
  • imports // default ['import { observer } from 'mobx-react';']
  • decorator // default 'observer'
  • classAfterFix // default 'Generated'
  • fileAfterFix // default '.generated'
  • useBase64Images // default false
  • typeFactory // default ({ props: componentProps }) => string
  • prettierOptions // default
{
  "parser": "babel",
  "semi": true,
  "tabWidth": 2,
  "printWidth": 140,
  "singleQuote": true,
  "trailingComma": "none"
}

Development

npm link

This repository uses Git Flow