add color customizations to VSCode settings and expand FAQ with new sections for clarity

Author: marcusrein

.vscode/settings.json

@@ -42,5 +42,10 @@
     "editor.suggest.insertMode": "replace",
     "editor.defaultFormatter": "biomejs.biome"
   },
-  "editor.tabSize": 2
+  "editor.tabSize": 2,
+  "workbench.colorCustomizations": {
+    "activityBar.background": "#053334",
+    "titleBar.activeBackground": "#074749",
+    "titleBar.activeForeground": "#ECFDFD"
+  }
 }

docs/docs/faq.md

@@ -17,6 +17,46 @@ tags: [faq]
 
 Yes—Hypergraph **is** your data layer. You still host a thin sync server, but your business logic lives entirely on the client.
 
+### Who is Hypergraph for?
+
+Developers building collaborative, consumer-facing apps that require real-time data sync, end-to-end encryption, and public knowledge graph interoperability. Ideal for those who want to focus on client-side logic without managing backend infrastructure.
+
+### What problems does Hypergraph solve?
+
+- Real-time sync of private data across users and devices with E2EE.
+- No traditional backend or database required—framework handles storage and sync.
+- Publishing and consuming public data in an interoperable knowledge graph.
+- Built-in user authentication and access control.
+- Enables network effects by reusing existing data across apps.
+
+### What assumptions do we make about developers?
+
+We assume you are comfortable writing React applications in TypeScript and familiar with common UI patterns (e.g., inboxes).
+
+### How can I integrate Hypergraph into an existing application?
+
+You can add Hypergraph as a collaboration and privacy layer to an existing app, enabling real-time sync and end-to-end encryption while keeping your current stack for other functionality.
+
+### Where can I find more examples or support?
+
+Browse our GitHub repository for sample apps and open issues. Join the community through our issue tracker and discussion forums.
+
+### How can I share feedback?
+
+Provide feedback via GitHub issues or our upcoming feedback form linked in the docs.
+
+### How do I get started?
+See our Quickstart guide: [🚀 Quickstart](/docs/quickstart).
+
+### What are Spaces?
+Spaces are the primary grouping for users and content in Hypergraph; they represent collaboration contexts and topics. Only members of a space can access its private data.
+
+### Where can I find the API reference?
+Refer to our API documentation: [📚 API Reference](/docs/api-reference).
+
+### How do I troubleshoot common errors?
+Find solutions in our Troubleshooting guide: [🛠 Troubleshooting](/docs/troubleshooting).
+
 ---
 
 ## Technical