new landing page #2078
Open
new landing page #2078
+13,672
−5,100
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
new landing — docs tweaks
|
@hasparus is attempting to deploy a commit to the The GraphQL Foundation Team on Vercel. A member of the Team first needs to authorize it. |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
benjie
reviewed
Aug 15, 2025
benjie
requested changes
Aug 15, 2025
Co-authored-by: Benjie <benjie@jemjie.com>
Co-authored-by: Benjie <benjie@jemjie.com>
* Extract edges and boxes out from the components. * Make diagram boxes and edges responsive * Make the diagram less tall * Animate client edge on small screens * Animate server edges on small screens * Remove next step on background click per Uri's request * Rotate query sideways on small screens
Co-authored-by: Benjie <benjie@jemjie.com>
|
Hey @benjie, I've applied your suggestions, so we're down to #2078 (comment) Could you tell me if the texts in the green use cases section are okay? 
I'm also not sure about this:
I know I'm being annoying, but GraphQL spec defines a type system, right? The service defines data types with a schema. |
Co-authored-by: Jeff Auriemma <bignimbus@users.noreply.github.com>
* Add [Try it out] link to the Hero * Add redirect from /docs to /learn
| href="/community/foundation" | ||
| className="flex items-center justify-between gap-4 whitespace-pre px-6 py-8 hover:bg-white/10 focus-visible:!-outline-offset-8 lg:h-1/3 lg:px-8 lg:pr-12 xl:gap-6" | ||
| > | ||
| Learn about GraphQL Foundation |
There was a problem hiding this comment.
Suggested change
| Learn about GraphQL Foundation | |
| Learn about the GraphQL Foundation |
| </h2> | ||
| <p className="typography-body-md max-w-[624px] text-neu-700"> | ||
| Facebook's mobile apps have been powered by GraphQL since 2012. The | ||
| GraphQL spec was open-sourced in 2015. Now it is used by |
There was a problem hiding this comment.
Suggested change
| GraphQL spec was open-sourced in 2015. Now it is used by | |
| GraphQL specification was open-sourced in 2015. Now it is used by |
Comment on lines
+20
to
+22
| "Deliver high-performance user experience at any scale", | ||
| "Secure and stabilize your API with a strongly typed schema and validated requests", | ||
| "Reduce communication overhead through efficient, distributed development", |
There was a problem hiding this comment.
I'm late to the party but this is a lot of words for my limited brain. Proposal for simplification:
Suggested change
| "Deliver high-performance user experience at any scale", | |
| "Secure and stabilize your API with a strongly typed schema and validated requests", | |
| "Reduce communication overhead through efficient, distributed development", | |
| "High-performance at any scale", | |
| "Typesafe schemas, secure requests", | |
| "Frictionless distributed development", |
My logaf is low and this has probably been bikeshedded already, feel free to discard my comment.
| </ul> | ||
|
|
||
| <div className="flex items-center gap-4"> | ||
| <Button href="/learn/#try-it-out">Try it out</Button> |
There was a problem hiding this comment.
YESSSSSSS!! Thank you! 🤩
| GraphQL is an open‑source query language for APIs and | ||
| a server‑side runtime. It provides a strongly‑typed schema to | ||
| define relationships between data, making APIs more flexible and | ||
| predictable. And it isn’t tied to a specific database or storage |
There was a problem hiding this comment.
Suggested change
| predictable. And it isn’t tied to a specific database or storage | |
| predictable. GraphQL isn’t tied to a specific database or storage |
Comment on lines
+32
to
+40
| overfetching to preserve battery and work on slow networks. With | ||
| libraries like{" "} | ||
| <a | ||
| className="typography-link" | ||
| href="https://nearform.com/open-source/urql/docs/graphcache/offline/#offline-behavior" | ||
| > | ||
| GraphCache | ||
| </a>{" "} | ||
| your app can work offline on planes and trains, and versionless schema |
There was a problem hiding this comment.
Let's keep the landing page vendor neutral?
Suggested change
| overfetching to preserve battery and work on slow networks. With | |
| libraries like{" "} | |
| <a | |
| className="typography-link" | |
| href="https://nearform.com/open-source/urql/docs/graphcache/offline/#offline-behavior" | |
| > | |
| GraphCache | |
| </a>{" "} | |
| your app can work offline on planes and trains, and versionless schema | |
| overfetching to preserve battery and work on slow networks. With | |
| a persistent normalized cache, | |
| your app can work offline on planes and trains, and versionless schema |
| { | ||
| label: "An AI-powered app", | ||
| description: | ||
| "Build apps with soft core using GraphQL MCP. Your schema documents itself, so AI agents can discover your API capabilities, understand data relationships, and generate valid queries without custom integration work.", |
There was a problem hiding this comment.
What is soft core in this context?
| description: | ||
| "Build apps with soft core using GraphQL MCP. Your schema documents itself, so AI agents can discover your API capabilities, understand data relationships, and generate valid queries without custom integration work.", | ||
| cta: "MCP GraphQL", | ||
| href: "https://github.com/graphql/graphql-mcp", |
learn — restyled left sidebar
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Howdy. I updated the landing page according to the new designs discussed in graphql/community-wg#21.
If you're interested in reading it step by step in chunks bigger than one commit, you can find the PRs reviewed by @saihaj in my fork hasparus/graphql.github.io/pulls?q=is+new-landing+.