📣 GraphQLConf 2024 • Sept 10-12 • San Francisco • Check out the Schedule & Get Your Ticket • Read more
Announcing New GraphQL Website

Announcing New GraphQL Website

by Dimitri Postolov & Uri Goldshtein

Hi, everyone! I’m Dimitri Postolov from The Guild, and today I’m excited to announce the new graphql.org website.

2 months ago, we released a new GraphQL website after 8 weeks period of development, we’re excited to share with you the reasons behind the changes and what you can expect going forward.

A Little Dive into History

An initial version of graphql.org v0 was created almost 8 years ago by Lee Byron in 2016.

Screenshot of initial version of graphql.org v0

An initial version of graphql.org v0

Later, after 4 years in 2020, the website was migrated to Gatsby by The Guild members Saihajpreet Singh and Arda Tanrikulu.

Screenshot of graphql.org v1 with Gatsby

graphql.org v1 x Gatsby

All of us GraphQL developers spent a lot of time learning this language from the “Learn” page, which is shown below, and you definitely remember it!

Also, we all disliked visiting this page at night due to the lack of a night theme. 😅

Screenshot of graphql.org v1 learn page

graphql.org Learn page x Gatsby

With the new website we’ve made a lot of improvements, including a dark theme! See how the “Learn” page looks now:

Screenshot of graphql.org v2 learn pageScreenshot of graphql.org v2 learn page

graphql.org Learn page x Nextra

What’s New

Here is a recap of the new features and improvements we’ve made to the website:

Migration to Nextra 3 & Vercel

We migrated from Gatsby & Netlify to Nextra and Next.js. We chose Nextra because it’s a great tool for building documentation websites, also The Guild maintains and improves it continuously. This migration helped us to improve the website’s performance and developer experience.

This migration was the final part before releasing the upcoming Nextra version. You can read my blog post about Nextra 3 in The Guild blog. Recently, we migrated all The Guild documentation websites to Nextra 3, so we know it’s stable for production.

While migrating this website, I started work on the future Nextra 4 version with app router support. Once the first Nextra 4 alpha is out, graphql.org will be updated to it!

New Search Engine

Search was migrated from Algolia to Nextra’s built-in search Flexsearch, providing users with realtime results and improved privacy.

Light and Dark Themes

For the first time since the creation of graphql.org, we have a dark theme! You can switch between light and dark themes using the toggle in the top right corner.

Improved Accessibility

Accessibility and contrast mode have been improved to make the website more accessible.

New /code and /community Pages

We are excited to show the new Code page which was renamed to “Tools and Libraries”. You can read in the GitHub repo how to contribute to this page and add your library or tool.

The community page was redesigned and restructured; now you can find all community resources in one place.

New /conf Page for GraphQLConf 2024

With the new website, we are excited to announce the upcoming GraphQLConf 2024. More info can be read on GraphQLConf 2024 page or in the official announcement blogpost.

Also, you can check the previous conference GraphQLConf 2023.

Conclusion

When I started to learn GraphQL in 2018, I could never have imagined that one day I would be working on this migration! I am excited to be a part of this journey and to have finally released the new website, a significant improvement over the old one! 🥳

Subscribe to me in X and GitHub and see you at GraphQLConf 2024 🚀.