console/README.md

102 lines
3.8 KiB
Markdown
Raw Normal View History

<!-- Graphql logo readme banner START -->
<p style="float: right; margin: 0 0 10px 10px;">
<a href="https://the-guild.dev">
<img src="https://the-guild-org.github.io/press-kit/full-dark-logo.svg" alt="Created by The guild" style="width: 100px;"/>
</a>
</p>
<!-- Graphql logo readme banner END -->
2022-05-18 07:26:57 +00:00
# GraphQL Hive
GraphQL Hive provides all the tools the get visibility of your GraphQL architecture at all stages,
from standalone APIs to composed schemas (Federation, Stitching).
2022-05-25 12:22:09 +00:00
2024-06-13 10:49:47 +00:00
- Visit [the-guild.dev/graphql/hive](https://the-guild.dev/graphql/hive)
([status page](https://status.graphql-hive.com))
- [Read the announcement blog post](https://the-guild.dev/blog/announcing-graphql-hive-public)
- [Read the docs](https://the-guild.dev/graphql/hive/docs)
2024-10-09 13:19:34 +00:00
- [View the changelog for self-hosting](./deployments/CHANGELOG.md)
2022-05-25 12:22:09 +00:00
## Built for the community, for all GraphQL APIs
2022-05-25 12:33:24 +00:00
2022-05-25 12:22:09 +00:00
GraphQL Hive has been built with 3 main objectives in mind:
- **Help GraphQL developers to get to know their GraphQL APIs** a little more with our Schema
Registry, Performance Monitoring, Alerts, and Integrations.
2022-05-25 12:22:09 +00:00
- **Support all kinds of GraphQL APIs**, from Federation, and Stitching, to standalone APIs.
2023-10-31 17:10:03 +00:00
- **Open Source at the heart**: 100% open-source and built in public with the community.
2023-03-08 09:17:43 +00:00
- **A plug and play Cloud solution**: to give access to Hive to most people with a generous free
"Hobby plan"
2022-05-25 12:22:09 +00:00
## Features Overview
### Schema Registry
GraphQL Hive offers 3 useful features to manage your GraphQL API:
- **Prevent breaking changes** - GraphQL Hive will run a set of checks and notify your team via
Slack, GitHub, or within the application.
2022-05-25 12:22:09 +00:00
- **Data-driven** definition of a “breaking change” based on Operations Monitoring.
- **History of changes** - an access to the full history of changes, even on a complex composed
schema (Federation, Stitching).
2022-05-25 12:22:09 +00:00
- **High-availability and multi-zone CDN** service based on Cloudflare to access Schema Registry
### Monitoring
Once a Schema is deployed, **it is important to be aware of how it is used and what is the
experience of its final users**.
2022-05-25 12:22:09 +00:00
## Self-hosted
GraphQL Hive is completely open-source under the MIT license, meaning that you are free to host on
your own infrastructure.
2022-05-25 12:22:09 +00:00
2024-10-09 13:19:34 +00:00
- [Changelog](./deployments/CHANGELOG.md)
2022-05-25 12:22:09 +00:00
GraphQL Hive helps you get a global overview of the usage of your GraphQL API with:
- Error rates and repartition
2023-10-31 17:10:03 +00:00
- Global and query performances (latency, RPM…)
2022-05-25 12:22:09 +00:00
- Operations count
- Active GraphQL clients
### Integrations
GraphQL Hive is well integrated with **Slack**, **MS Teams** and most **CI/CD** systems to get you
up and running as smoothly as possible!
2022-05-25 12:22:09 +00:00
GraphQL Hive can notify your team when schema changes occur, either via Slack, MS Teams or a custom
webhook.
2022-05-25 12:22:09 +00:00
Also, the Hive CLI allows integration of the schema checks mechanism to all CI/CD systems (GitHub,
2023-10-31 17:10:03 +00:00
BitBucket, Azure, and others). The same applies to schema publishing and operations checks.
2022-05-25 12:22:09 +00:00
If you are using GitHub, you can directly benefit from the **GraphQL Hive app that will
automatically add status checks to your PRs**!
2022-05-25 12:22:09 +00:00
### Join us in building the future of GraphQL Hive
Like all [The Guild](https://the-guild.dev) projects, GraphQL Hive is built with the community.
We can't wait to get you onboard and get your feedback, pull requests, and feature requests.
See you in Hive! 🐝
2022-05-18 07:26:57 +00:00
## Project Stack
2022-12-14 11:59:39 +00:00
- General: NodeJS, TypeScript
- Authentication: SuperTokens
- HTTP Server: Fastify
2023-03-08 09:17:43 +00:00
- APIs: GraphQL, GraphQL-Yoga, GraphQL-Codegen, GraphQL-Inspector, GraphQL-Modules
New redesign (#4) * New redesign * Use latest nextjs and bob It fixes the start command * fix: text overflow issue in the organization switcher dropdown (#14) * fix: text overflow issue in the organization switcher dropdown * feat: strict children typings * Force dark mode (#15) If somebody used the light mode before, Hive App displays light version of tailwind classes * Fix dev, GH app optional, project type instead of Connected (#16) * Make Github integration optional * Show project type instead of Connected * Fix dev command * Small changes to the version card (#17) * Small changes to the version card * Apply suggestions from code review * Polish (#18) * Make the design a bit more clean * Add a bit of separation * Apply suggestions from code review Co-authored-by: Dimitri POSTOLOV <en3m@ya.ru> Co-authored-by: Dimitri POSTOLOV <en3m@ya.ru> * fix: do not access properties on potential undefined variable (#33) * fix: renaming not being added during rebase (#32) * feat: add Mutation.createToken validation (#30) * Remove `#` from organization pages, polish subcription page (#34) * Remove `#` from project/target pages (#38) * fix: add missing service names for multi service projects (#35) * Re-design subscription (#40) * Missing list of changes in the schema diff view (#41) * Missing list of changes in the schema diff view Closes #19 * Apply suggestions from code review Co-authored-by: Dimitri POSTOLOV <en3m@ya.ru> * Move titleMap outside of the component Co-authored-by: Dimitri POSTOLOV <en3m@ya.ru> * Blurred fixed header + new `404` page + use `@theguild/prettier-config` (#44) * fix header * make things amazing * Update packages/web/app/pages/404.tsx * fix build * remove unused styles * Add --fix to lint-staged (#43) * Fix access (#45) * Fix access on organization level * Fix access on project level * Fix access on target level * Align with main * Bring back schema view (#49) * Add missing Mark as Valid button (#50) * Update the design of the operations view (#51) * Update doc link Co-authored-by: Dotan Simha <dotansimha@gmail.com> Co-authored-by: Kamil Kisiela <kamil.kisiela@gmail.com> Co-authored-by: Laurin Quast <laurinquast@googlemail.com>
2022-05-24 07:41:53 +00:00
- App: React, Next.js, Tailwind CSS, Radix Primitives
2022-05-18 07:26:57 +00:00
- CLI: Oclif
2023-03-08 09:17:43 +00:00
- Deployment (Cloud): Pulumi, K8s, Contour (Envoy), Azure Cloud, CloudFlare Workers, CloudFlare R2
- Monitoring: Prometheus, Grafana, Sentry
2022-12-14 11:59:39 +00:00
- Databases: Postgres, Redis, ClickHouse
2022-05-18 07:26:57 +00:00
## Docs
- [Development](./docs/DEVELOPMENT.md)
2023-08-22 14:39:43 +00:00
- [Deployment](./docs/DEPLOYMENT.md)
2022-05-18 07:26:57 +00:00
- [Testing](./docs/TESTING.md)