Document Babel macros support and common uses

[gaearon]

Need to keep track:

• Relay Support babel-plugin-macros relay#2171
• Apollo "SVG as a component" doesn't quite work in 2.x #3856 (comment)
• Css-in-js like Emotion
• Maybe some i18n libs?
• SVG "SVG as a component" doesn't quite work in 2.x #3856 (comment)
• Maybe make one for idx? https://github.com/dralletje/idx.macro

[gaearon]

cc @kentcdodds do you have a list somewhere/

[threepointone]

partial application with https://github.com/citycide/param.macro

[threepointone]

emotion https://github.com/emotion-js/emotion/tree/master/packages/babel-plugin-emotion#babel-macros (needs a better doc page ofc)

[kentcdodds]

I should note that some plugins have still not upgraded from babel-macros to babel-plugin-macros. In any case, the documentation of babel-plugin-macros indicates that people should use the keyword babel-plugin-macros in their package.json to facilitate finding available macros.

• babel-macros keyword
• babel-plugin-macros keyword

[threepointone]

idx! https://github.com/dralletje/idx.macro

[kentcdodds]

Also, I'll be giving a talk at a meetup in two weeks about using babel-plugin-macros with create-react-app. I'll make sure that's recorded and add a link to the docs 👍

[kentcdodds]

I just added a macros.md file to the babel-plugin-macros docs. Feel free to direct people there!

[kentcdodds]

Here's the recording of my talk 😄

[Downchuck]

A sterling example of a painful case of css plugin:
umijs/babel-plugin-import#166

[lifeiscontent]

not sure if this is create-react-app related or webpack related as @kentcdodds pointed out, but the errors when something doesn't compile in babel-macros are very unhelpful. kentcdodds/babel-plugin-macros#79

[kentcdodds]

I believe it has nothing to do with babel macros specifically and is more generally babel...

[lifeiscontent]

right, sorry for not clarifying that @kentcdodds

[caedmon]

Not sure if this is the right place to ask this, but is babel-plugin-macros supposed to be working with 2.0.0-next.a671462c? I've tried to use it but haven't been able to get more than the rather opaque 'Failed to compile.' when I try to use a macro.