Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hoangvvo/benzene
⌬ Fast, minimal, agnostic GraphQL Servers ⌬
https://github.com/hoangvvo/benzene
cloudflare-workers deno graphql graphql-server javascript node websocket
Last synced: about 11 hours ago
JSON representation
⌬ Fast, minimal, agnostic GraphQL Servers ⌬
- Host: GitHub
- URL: https://github.com/hoangvvo/benzene
- Owner: hoangvvo
- License: other
- Created: 2020-08-27T13:14:27.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-13T16:23:13.000Z (over 2 years ago)
- Last Synced: 2025-01-05T22:09:11.444Z (8 days ago)
- Topics: cloudflare-workers, deno, graphql, graphql-server, javascript, node, websocket
- Language: TypeScript
- Homepage: https://benzene.vercel.app
- Size: 1.81 MB
- Stars: 164
- Watchers: 4
- Forks: 7
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Benzene is a new take on GraphQL server that gives us the control we need while staying blazing fast.
[](https://codecov.io/gh/hoangvvo/benzene)
[](/CONTRIBUTING.md)
## Features
The `@benzene/http` and `@benzene/ws` packages allow us to build a full-featured GraphQL server, featuring:
- **Super minimal ([~4kB](https://bundlephobia.com/result?p=@benzene/core)) and [performant](/benchmarks)**. `@benzene/http` and `@benzene/ws` purely wrap `@benzene/core`, which includes minimal dependencies and features no third-party integrations, thus avoiding unnecessary overheads.
- **Transport & Framework agnostic**. Each package features generic Request, Response, or WebSocket interfaces to easily plug into any JavaScript frameworks or runtimes: [Node.js](./examples/with-http), [Deno](./examples/deno), [Cloudflare Worker](./examples/cloudflare-workers), etc.
- **Customizable runtime**. Use custom GraphQL implementation such as [`graphql-jit`](https://github.com/zalando-incubator/graphql-jit) or rolling our own for performance and cutting-edge features.
- **Unopinionated and observable APIs**. Benzene does not include any middleware or configurations, so we can be in total control of logging, parsing, and error handling.
- **Unified pipeline**. Write error handling or context creation function only once. Every transport handler inherits the same [Benzene instance](https://benzene.vercel.app/reference/benzene) and takes advantage of its shared configuration.
- **Fully extensible**. Despite not being battery-included, it can be extended with _recipes_ (like [Persisted queries](https://benzene.vercel.app/recipes/persisted-queries)) or [@benzene/extra](https://www.npmjs.com/package/@benzene/extra).
We are taking an approach opposite to [Apollo Server](https://github.com/apollographql/apollo-server), which abstracts everything behind its `applyMiddleware` function that includes unexpected and hard-to-customized "defaults".
While our approach requires a bit more boilerplate, we achieve an observable and customizable server integration.
## Documentation
Documentation is available at [benzene.vercel.app](https://benzene.vercel.app)
There is also a [Getting Started](https://benzene.vercel.app/getting-started) section
which shows how to build a _real-time_ book voting app using both `@benzene/http` and `@benzene/ws`.
## Examples
There are also various [examples](examples) for integrations with different tools and frameworks.
## Contributing
This repository uses the new [npm v7 workspaces](https://docs.npmjs.com/cli/v7/using-npm/workspaces) ([yarn 1 workspace](https://classic.yarnpkg.com/en/docs/workspaces/) may also work). Please see [contributing.md](CONTRIBUTING.md).
## License
[MIT](LICENSE)