From abad10ec9e57d2e61b6a496020096055de1494e8 Mon Sep 17 00:00:00 2001
From: Daniel Olshansky <olshansky.daniel@gmail.com>
Date: Mon, 9 Dec 2024 08:08:34 -0800
Subject: [PATCH] Update README: `It's like GraphQL, but for Postgres.` (#2120)

1. Minor NITs & formatting fixes
2. Add Table of Contents
3. Add a new tagline

---------

Co-authored-by: Kyle Mathews <mathews.kyle@gmail.com>
---
 README.md | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index b26b9b9a19..8270ea9d48 100644
--- a/README.md
+++ b/README.md
@@ -23,10 +23,21 @@
   <a href="https://x.com/ElectricSQL" target="_blank"><img src="https://img.shields.io/twitter/follow/ElectricSQL.svg?style=social&label=Follow @ElectricSQL"></a>
 </p>
 
-# Electric
+# Electric <!-- omit in toc -->
 
 Your Postgres data, in sync, wherever you need it.
 
+**Table of Contents:**
+
+- [Quick links](#quick-links)
+- [What is Electric?](#what-is-electric)
+- [Getting Started](#getting-started)
+- [HTTP API Docs](#http-api-docs)
+- [Developing Electric](#developing-electric)
+  - [Mac setup](#mac-setup)
+- [Contributing](#contributing)
+- [Support](#support)
+
 ## Quick links
 
 - [Quickstart](https://electric-sql.com/docs/quickstart)
@@ -38,7 +49,7 @@ Your Postgres data, in sync, wherever you need it.
 
 Electric provides an [HTTP API](https://electric-sql.com/docs/api/http) for syncing [Shapes](https://electric-sql.com/docs/guides/shapes) of data from Postgres. This can be used directly or via [client libraries](https://electric-sql.com/docs/api/clients/typescript) and [integrations](https://electric-sql.com/docs/api/integrations/react).
 
-### This looks a bit different than the last time I visited?
+### This looks a bit different than the last time I visited? <!-- omit in toc -->
 
 We started a clean rebuild of the sync engine in July 2024. One that's informed by the lessons learned building the [previous system](https://github.com/electric-sql/electric-old). See
 [James' blog post for background on the change](https://electric-sql.com/blog/2024/07/17/electric-next).
@@ -65,15 +76,15 @@ curl -i 'http://localhost:3000/v1/shape?table=foo&offset=-1'
 Or use one of the clients or integrations, such as the [`useShape`](https://electric-sql.com/docs/api/integrations/react) React hook:
 
 ```jsx
-import { useShape } from '@electric-sql/react'
+import { useShape } from "@electric-sql/react"
 
 function Component() {
   const { data } = useShape({
     url: `http://localhost:3000/v1/shape`,
     params: {
       table: `foo`,
-      where: `title LIKE 'foo%'`
-    }
+      where: `title LIKE 'foo%'`,
+    },
   })
 
   return JSON.stringify(data)