Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/babel-blade/babel-blade
(under new management!) ⛸️Solve the Double Declaration problem with inline GraphQL. Babel plugin/macro that works with any GraphQL client!
https://github.com/babel-blade/babel-blade
babel babel-macros babel-plugin babel-plugin-macros graphql graphql-client react reactjs
Last synced: 2 months ago
JSON representation
(under new management!) ⛸️Solve the Double Declaration problem with inline GraphQL. Babel plugin/macro that works with any GraphQL client!
- Host: GitHub
- URL: https://github.com/babel-blade/babel-blade
- Owner: babel-blade
- Created: 2018-07-08T00:12:36.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-12-13T01:19:35.000Z (about 5 years ago)
- Last Synced: 2024-04-13T03:40:26.818Z (8 months ago)
- Topics: babel, babel-macros, babel-plugin, babel-plugin-macros, graphql, graphql-client, react, reactjs
- Language: JavaScript
- Homepage: https://babel-blade.netlify.com/
- Size: 361 KB
- Stars: 272
- Watchers: 8
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome - babel-blade - (SEEKING MAINTAINER) ⛸️Solve the Double Declaration problem with inline GraphQL. Babel plugin/macro that works with any GraphQL client! (HTML)
- awesome-list - babel-blade - blade | 267 | (JavaScript)
README
> Welcome! This project is **STILL A WORK IN PROGRESS** and not yet production ready - but I appreciate you trying this out and giving feedback!
# Babel-Blade ⛸️
`babel-blade` is the collective name for the babel plugin/macro that helps to generate graphql query strings inline and solves [the double declaration problem](https://babel-blade.netlify.com/docs/declarationdeclaration.html).
Check **[our new Docs site](https://babel-blade.netlify.com/)** or view [my 7 minute talk at React Boston](https://youtu.be/30wOsJOluA4?t=497) for an explainer!
[![babel blade walkthrough on youtube](https://user-images.githubusercontent.com/6764957/48116756-ef34a800-e21b-11e8-9d4f-049362c25b23.gif)](https://www.youtube.com/watch?v=z9wKcRjNqlw)
# Seriously check out our 👉 [our new Docs site](https://babel-blade.netlify.com/) 👈
Have you heard that we have a **[new Docs site](https://babel-blade.netlify.com/)**? It's in Docusaurus and it's great!
---
## Obligatory Social Proof
> "This is gonna be huge! Colocated graphql queries to the extreme, Completely autogenerated from your code. Super great dev experience & maintainable to the max. 🤗 Use with whatever graphql client framework you want. 🎉 "
> "Just took a look at babel-blade. Oh man, does that reverse engineer your gql queries from your usages?????? 👏👏👏"
> "Fucking great"
Ken Wheeler, probably> "Super duper"
---
# For developers of plugins/contributors
## boilerplate
This monorepo was bootstrapped from [babel-plugin-macro-boilerplate](https://github.com/sw-yx/babel-plugin-macro-boilerplate). Check it out if you want to make one!
**if you spot something that could be a better practice, PLEASE open an issue or [tell me I'm wrong!](https://twitter.com/swyx)**
---
# For contributors/swyx
## Guide to this repository
This is a monorepo managed by [`lerna`](https://lernajs.io). Let's go through the folder structure:
- `/docs`: source markdown files for our Docusaurus docs
- `/website`: the rest of the files (React, Site config, etc) for our Docusaurus docs
- `/packages/babel.macro`: a very small/insignificant wrapper of `babel-plugin-blade` for hooking into `babel-plugin-macros`. Published as [blade.macro](https://npm.im/blade.macro).
- `/packages/babel-plugin-blade`: the core of this repo, the secret sauce. Published as [babel-plugin-blade](https://npm.im/babel-plugin-blade). It has a separate README, go in there if interested to learn more about its inner workings. If you are just looking to use `babel-plugin-blade` you can just check out **[our new Docs site](https://babel-blade.netlify.com/)**.## publishing check list
1. `npm run build` on `packages/babel-plugin-blade`
2. `lerna publish`