Convert docs to MkDocs with Material theme for GitHub Pages (#5)

- Restructure markdown files into docs/ directory with stellar/ subdirectory
  to support multiple projects
- Add mkdocs.yml with Material theme (light/dark mode, code copy, search)
- Add GitHub Actions workflow to auto-deploy on push to master using uv
- Add Makefile with serve and build targets
- Remove standalone TypeScript example project (inline examples are sufficient)
- Pin mkdocs <2 and mkdocs-material <9.6 to avoid compatibility warnings

Author: mattrasband

.github/workflows/deploy.yml

@@ -0,0 +1,19 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uvx --with 'mkdocs>=1.6,<2' --with 'mkdocs-material>=9.5,<9.6' mkdocs gh-deploy --force

.gitignore

@@ -0,0 +1 @@
+site/

CLAUDE.md

@@ -4,15 +4,23 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Repository Purpose
 
-This is a documentation repository for Volta, containing integration guides and API documentation for Stellar/Soroban. There is no build system, tests, or application code - only Markdown documentation files and TypeScript examples.
+This is a documentation repository for Volta, built with MkDocs (Material theme) and deployed to GitHub Pages. Contains integration guides and API documentation for Stellar/Soroban.
+
+## Build
+
+- `make serve` - Local dev server
+- `make build` - Build static site to `site/`
+- Deploys automatically to GitHub Pages on push to `master` via `.github/workflows/deploy.yml`
 
 ## Structure
 
-- `stellar/` - Soroban smart contract integration documentation
-  - `README.md` - Complete API reference with TypeScript and Go code examples
-  - `troubleshooting.md` - Error codes and common issues
-  - `tutorials/` - Step-by-step guides (getting-started, first-proposal, integration)
-  - `examples/typescript/` - Runnable TypeScript example project
+- `docs/` - MkDocs source (Markdown documentation)
+  - `index.md` - Top-level landing page
+  - `stellar/` - Soroban smart contract integration docs
+    - `index.md` - API reference with TypeScript and Go examples
+    - `troubleshooting.md` - Error codes and common issues
+    - `tutorials/` - Step-by-step guides (getting-started, first-proposal, integration)
+- `mkdocs.yml` - MkDocs configuration
 
 ## Volta Contract Overview
 

Makefile

@@ -0,0 +1,9 @@
+UV_ARGS = --with 'mkdocs>=1.6,<2' --with 'mkdocs-material>=9.5,<9.6'
+
+.PHONY: serve build
+
+serve:
+	uvx $(UV_ARGS) mkdocs serve
+
+build:
+	uvx $(UV_ARGS) mkdocs build

docs/index.md

@@ -0,0 +1,7 @@
+# Volta Documentation
+
+Welcome to the Volta documentation.
+
+## Integrations
+
+- **[Stellar/Soroban](stellar/index.md)** - Multi-signature governance contract integration guide

stellar/README.md docs/stellar/index.mdstellar/README.md renamed to docs/stellar/index.md

@@ -943,4 +943,3 @@ const eventStream = rpc.subscribe({
 
 - [Soroban Documentation](https://soroban.stellar.org/docs)
 - [Stellar SDK Documentation](https://developers.stellar.org/docs)
-- [Contract Source Code](../../smart-contract-soroban)

stellar/troubleshooting.md docs/stellar/troubleshooting.mdstellar/troubleshooting.md renamed to docs/stellar/troubleshooting.md

@@ -338,5 +338,5 @@ function handleContractError(error: any) {
 
 ## Next Steps
 
-- [API Reference](../README.md)
+- [API Reference](../index.md)
 - [Troubleshooting Guide](../troubleshooting.md)