{{project-name}} Chat

A simple real-time chat application built with Ankurah, demonstrating distributed reactive updates across React frontend and Rust backend.

Features

• Real-time message synchronization
• Persistent storage (Sled on server, IndexedDB in browser)
• Automatic user creation with localStorage persistence
• WebSocket-based peer communication
• Reactive UI updates

Architecture

• model/ - Shared data models (User, Room, Message)
• server/ - Rust server with Sled storage and WebSocket connector
• wasm-bindings/ - WASM bindings exposing Ankurah to JavaScript
• react-app/ - React frontend application

Quick Start

1. Build and run the server

cargo run -p {{project-name}}-server

The server will:

• Initialize Sled storage at ~/.{{project-name}}/
• Create a "General" chat room
• Listen for WebSocket connections on 127.0.0.1:9898

2. Build the WASM bindings

cd wasm-bindings
wasm-pack build --target web --dev
cd ..

3. Run the React app

cd react-app
bun install
bun run dev

The app will be available at http://localhost:5173

Models

User

• display_name: String (YrsString) - User's display name

Room

• name: String (YrsString) - Room name

Message

• user: String (LWW) - User ID who sent the message
• room: String (LWW) - Room ID where message was sent
• text: String (YrsString) - Message content
• timestamp: i64 (LWW) - Unix timestamp in milliseconds

Development

Building for production

# Server
cargo build --release -p {{project-name}}-server

# WASM
cd wasm-bindings && wasm-pack build --target web --release

# React app
cd react-app && bun run build

License

MIT or Apache-2.0