Extending docs - added blog entry and improved design (#209)

Author: marcusrein

docs/README.md

@@ -9,15 +9,15 @@ This website is built using [Docusaurus](https://docusaurus.io/), a modern stati
 Install all dependencies from the monorepo root:
 
 ```
-$ pnpm install
+pnpm install
 ```
 
 ### Local Development
 
 Start the Docusaurus dev server for the docs site:
 
 ```
-$ pnpm --filter docs start
+pnpm --filter docs start
 ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
@@ -27,7 +27,7 @@ This command starts a local development server and opens up a browser window. Mo
 Build the static site:
 
 ```
-$ pnpm --filter docs build
+pnpm --filter docs build
 ```
 
 This command generates static content into the `build` directory and can be served using any static content hosting service.
@@ -37,13 +37,13 @@ This command generates static content into the `build` directory and can be serv
 Using SSH:
 
 ```
-$ USE_SSH=true pnpm --filter docs deploy
+USE_SSH=true pnpm --filter docs deploy
 ```
 
 Not using SSH:
 
 ```
-$ GIT_USER=<Your GitHub username> pnpm --filter docs deploy
+GIT_USER=<Your GitHub username> pnpm --filter docs deploy
 ```
 
 If you are using GitHub Pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

docs/blog/2019-05-28-first-blog-post.md

@@ -0,0 +1,63 @@
+---
+slug: hypergraph-alpha-released
+title: Announcing Hypergraph - A New Chapter in Web Development
+date: 2025-06-11
+authors: [nik, pablo]
+tags: [release, alpha, hypergraph]
+---
+
+After months of development and countless conversations with developers like you, **we're thrilled to unveil the Alpha version of Hypergraph**. This is more than just another data layer—it's a fundamental rethinking of how we build collaborative, secure, and offline-first Web3 applications.
+
+<!-- truncate -->
+
+## Why We Built Hypergraph
+
+The challenges of modern app development are clear: users expect real-time collaboration, bulletproof security, and apps that work flawlessly even when offline. Traditional architectures force uncomfortable trade-offs between these needs. We knew there had to be a better way.
+
+Enter Hypergraph, built on two core innovations: a local-first architecture that puts your data where it belongs—on the client—and our implementation of the GRC-20 standard for truly composable knowledge graphs.
+
+<!-- TODO: ADD IMAGE OF HYPGRAPH UI -->
+
+## What Makes Hypergraph Different
+
+At its heart, Hypergraph is local-first. Every piece of data is stored on the client, making reads and writes instant—no waiting for server responses. When you're online, our CRDT-based sync ensures your data flows seamlessly between devices and collaborators. When you're offline? Everything just works.
+
+Security isn't an afterthought—it's built into our foundation. With end-to-end encryption, your data is only readable by those you explicitly trust. No intermediaries, no compromises.
+
+The real magic happens with our GRC-20 Knowledge Graph. It's not just a data format; it's a new way of thinking about how information connects and flows through your applications. Every mutation, whether it's adding a note or updating a relationship, becomes part of a larger, interoperable knowledge network.
+
+<!-- TODO: ADD GIF OF DATA MODEL -->
+
+## Looking Ahead
+
+We're launching this alpha today, June 10, 2025, and we're targeting a beta release in August. Our roadmap to a stable release in Q4 2025 is ambitious but achievable with your help. The beta will bring enhanced stability, an expanded API surface, and comprehensive documentation based on your feedback.
+
+## Join the Alpha Today
+
+Getting started is simple. Install our SDK:
+
+```bash
+# TODO: ADD INSTALLER TO NPM npm install @hypergraph/sdk-alpha
+```
+
+Head to our [Quickstart guide](/docs/quickstart) to build your first Hypergraph app, or dive deep into our [API Reference](/docs/api-reference) to explore the possibilities. We support Node.js and modern browsers, with React hooks that make integration a breeze.
+
+## A Note on What to Expect
+
+Let's be transparent: this is an alpha release. You'll see rapid changes as we iterate based on your feedback. Some features are still experimental, and you might encounter sync delays with larger graphs or limited support on mobile browsers. But that's exactly why we need you—every bug report, feature request, and question helps shape Hypergraph's future.
+
+## Let's Build Together
+
+Your voice matters in this journey. Share your experiences, report issues, or just chat with us:
+
+- Found a bug? [Open an issue on GitHub](https://github.com/graphprotocol/hypergraph/issues)
+<!-- TODO: Get /discussions set up in github - Have ideas? Join the discussion on [GitHub Discussions](https://github.com/graphprotocol/hypergraph/discussions) -->
+- Want to chat? Find us on [Discord](https://discord.gg/graphprotocol)
+
+We read every message and your feedback directly shapes our roadmap.
+
+## Ready to Shape the Future?
+
+This is just the beginning. Hypergraph represents our vision for the future of Web3 development, but it's your creativity and feedback that will help us realize its full potential. [Get started with the Quickstart](/docs/quickstart), and explore our [API Reference](/docs/api-reference), and join us in building the next generation of collaborative, decentralized applications.
+
+We can't wait to see what you'll create.

docs/blog/2019-05-29-long-blog-post.md

@@ -1,23 +1,23 @@
-yangshun:
-  name: Yangshun Tay
-  title: Front End Engineer @ Facebook
-  url: https://github.com/yangshun
-  image_url: https://github.com/yangshun.png
+pablo:
+  name: Pablo Carranza Velez
+  title: Engineering Manager @ Edge & Node
+  url: https://github.com/pcarranzav
+  image_url: https://avatars.githubusercontent.com/u/2223590?v=4
+  permalink: /all-pablo-articles
   page: true
   socials:
-    x: yangshunz
-    github: yangshun
+    x: https://x.com/pcarranzav
+    github: https://github.com/pcarranzav
 
-slorber:
-  name: Sébastien Lorber
-  title: Docusaurus maintainer
-  url: https://sebastienlorber.com
-  image_url: https://github.com/slorber.png
+nik:
+  name: Nik
+  title: Hypergraph Lead Engineer @ Geo
+  # url: 
+  image_url: https://ca.slack-edge.com/T047DS7N1PE-U07PPQ3GN7Q-gafcee4ad6e3-512
   page:
-    # customize the url of the author page at /blog/authors/<permalink>
-    permalink: '/all-sebastien-lorber-articles'
-  socials:
-    x: sebastienlorber
-    linkedin: sebastienlorber
-    github: slorber
-    newsletter: https://thisweekinreact.com
+    permalink: /all-nik-articles
+  # socials:
+    # x: 
+    # linkedin: 
+    # github: 
+    # newsletter: https://thisweekinreact.com

docs/blog/2021-08-01-mdx-blog-post.mdx

@@ -1,19 +1,40 @@
-facebook:
-  label: Facebook
-  permalink: /facebook
-  description: Facebook tag description
-
-hello:
-  label: Hello
-  permalink: /hello
-  description: Hello tag description
-
 docusaurus:
   label: Docusaurus
   permalink: /docusaurus
   description: Docusaurus tag description
 
-hola:
-  label: Hola
-  permalink: /hola
-  description: Hola tag description
+release:
+  label: Release
+  permalink: /release
+  description: Release announcements and updates
+
+alpha:
+  label: Alpha
+  permalink: /alpha
+  description: Alpha version releases and features
+
+hypergraph:
+  label: Hypergraph
+  permalink: /hypergraph
+  description: Posts about Hypergraph features and updates
+
+knowledge-graphs:
+  label: Knowledge Graphs
+  permalink: /knowledge-graphs
+  description: Articles about knowledge graph concepts, best practices, and implementation
+
+education:
+  label: Education
+  permalink: /education
+  description: Educational content and tutorials
+
+best-practices:
+  label: Best Practices
+  permalink: /best-practices
+  description: Guidelines, conventions, and recommended practices
+
+grc20:
+  label: GRC-20
+  permalink: /grc20
+  description: Content related to the GRC-20 knowledge graph specification
+

docs/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg

@@ -49,6 +49,7 @@ const config = {
         },
         blog: {
           showReadingTime: true,
+          blogSidebarCount: 'ALL',
           feedOptions: {
             type: ['rss', 'atom'],
             xslt: true,
@@ -71,6 +72,7 @@ const config = {
   themeConfig:
     /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
     ({
+      colorMode: { defaultMode: 'dark', disableSwitch: true },
       // Replace with your project's social card
       image: 'img/docusaurus-social-card.jpg',
       navbar: {