Merge branch 'main' of https://github.com/SPID-Protocol-project/spidprotocol-docs

Author: rjewett459

README.md

@@ -1,41 +1,116 @@
-# Website
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+# SPID Protocol Documentation
 
-### Installation
+<img src="https://raw.githubusercontent.com/SPID-Protocol-project/spidprotocol-docs/main/static/img/spid_icon_dark.png" alt="SPID Protocol Logo" width="180" />
 
-```
-$ yarn
-```
+**The Smart Packet Identity Layer (SPID)** is an open protocol that powers AI-native, voice-ready communication through structured metadata and universal identifiers. This repository contains the official documentation for SPID and its core components.
 
-### Local Development
+---
 
-```
-$ yarn start
-```
+## 🚀 What is the SPID Protocol?
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+The SPID Protocol defines a new standard for async, AI-mediated communication using **Smart Packets** — rich, structured messages containing:
 
-### Build
+- A short voice message
+- A full transcript
+- Inferred user intent
+- Actionable CTA buttons
+- Verified identity and metadata
 
-```
-$ yarn build
-```
+SPID is the identity and resolution layer that links each packet to its origin, purpose, and destination. Think of it as **DNS + Schema.org + Email headers for the AI web** — enabling machines to route, respond, and retrieve context-aware messages without noise or ambiguity.
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+---
 
-### Deployment
+## 🧠 Why It Matters
 
-Using SSH:
+Traditional communication (email, calls, SMS) is outdated for an AI-driven world. Smart Packets and SPID enable:
 
-```
-$ USE_SSH=true yarn deploy
-```
+- ✅ **Voice-first communication** that’s human-friendly and AI-optimized
+- 🧩 **Structured data** that powers LLM routing and reasoning
+- 🕸️ **Linkable metadata** for seamless discovery and retrieval
+- 🔐 **Verified identity and intent**, protecting against spam and impersonation
+- 📦 **Portable messages**, ready to be shared, archived, or embedded anywhere
 
-Not using SSH:
+---
 
+## 📚 Documentation Contents
+
+This repository is built with [Docusaurus](https://docusaurus.io) and contains:
+
+- `docs/` — Core specs, guides, and implementation details
+- `static/` — SPID logo assets and shared resources
+- `docusaurus.config.js` — Site configuration and navbar settings
+
+---
+
+## 📦 Get Started
+
+To contribute or run locally:
+
+```bash
+# Install dependencies
+npm install
+
+# Start local dev server
+npm run start
 ```
-$ GIT_USER=<Your GitHub username> yarn 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.
+Visit [http://localhost:3000/spidprotocol-docs](http://localhost:3000/spidprotocol-docs) to preview the documentation locally.
+
+---
+
+## 🌐 Live Docs
+
+You can explore the live documentation here:  
+👉 **[spidprotocol.org/docs](https://spidprotocol.org/docs)** *(or your deployment link)*
+
+---
+
+## 🛠️ Core Concepts
+
+- **Smart Packets** – AI-native, voice-powered messages
+- **SPID** – Unique identifier + resolver for every packet
+- **Intent Schema** – Machine-readable tags for AI inference
+- **PulseID** – Optional inbox layer for individuals and agents
+- **SPID Directory** – Registry of public Smart Packets and identities
+
+---
+
+## 🧩 Related Projects
+
+- [`smartpacket.dev`](https://smartpacket.dev) – Smart Packet creator tools
+- [`voicemate.id`](https://voicemate.id) – Personal voice inboxes
+- [`spid.directory`](https://spid.directory) – Public Smart Packet directory
+
+---
+
+## 🤝 Contributing
+
+We welcome open collaboration. To get involved:
+
+- Fork the repo
+- Create a new branch
+- Submit a pull request
+
+For major changes, please open an issue first to discuss scope and alignment with the protocol spec.
+
+---
+
+## 🧠 Learn More
+
+SPID is designed to be a foundational protocol for a more human, async, AI-first future. This project is maintained by [ChatSites Labs](https://chatsites.ai) and its contributors.
+
+For updates, roadmap, and use cases, visit:
+
+👉 [spidprotocol.org](https://spidprotocol.org)  
+👉 [docs.spidprotocol.org](https://spidprotocol.org/docs)
+
+---
+
+## 📄 License
+
+This project is open-source under the [MIT License](LICENSE).
+
+---
+
+*Built for the era of structured, sovereign, and voice-ready communication.*