A freeform alternative to GraphQL for Gatsby.
The repository contains the development site (/site) that could automatically load packages (packages) thanks to yarn workspaces.
| Package | Summary | Version |
|---|---|---|
| Gatsby Source Flapper Plugin | plugin providing freeform alternative to Gatsby's GraphQL model |  |
- Development Site - Site using for development purposes and code examples showcasing packages possibilities
Coming soon.
-
Install packages
yarn # install all npm dependencies in the repository -
Start watch mode packages
yarn build # build all packages -
Run development site
yarn develop:site # run `gatsby develop` command in the development site
Now you are good to go. You could start browsing http://localhost:8000 for development site and http://localhost:8000/___graphql for GraphiQL explorer.
To build all of the packages as well as a development site, you could use one command.
yarn build # run build script in all packages as well as in the development site- Packages are using ESLint with Typescript plugins for linting.
As a publishing framework, there is a Lerna framework set up. This package is using Independent mode.
If you have the rights to publish packages, just use lerna and specify the version when prompted. All the changes made by lerna are automatically committed.
A typical scenario is when everything is ready and you want to publish the version, just use command.
npx lerna publish --tag-version-prefix=''That should summarize the publish information and prompt you to define the version number and acknowledge the publish. Once everything is OK and you acknowledge the publish:
- the new version is published to npm
<YOUR VERSION>is set tolerna.json'sversion- commit with this change (and package.json files version changes) is pushed to the repository
- commit also contains tag
<YOUR VERSION>that could be used for creating GitHub release if you want
💡 If you want to test out the beta version first (which is recommended) use following command and if everything is OK, release another patch version as the final version.
npx lerna publish --tag-version-prefix='' --dist-tag=beta