wasmCloud TypeScript

TypeScript ecosystem libraries, applications, and examples for wasmCloud.

Overview

This repository is a TypeScript monorepo containing libraries, applications, and examples for building with wasmCloud. It includes:

• Libraries (packages/) - Reusable TypeScript packages for wasmCloud development
• Applications (apps/) - Production applications built with wasmCloud
• Examples (examples/) - Sample components and usage patterns
• Templates (templates/) - Project templates for scaffolding new wasmCloud components

📦 Packages

Package	Description
@wasmcloud/lattice-client-core	Core TypeScript client for wasmCloud lattice operations
@wasmcloud/lattice-client-react	React hooks and components for wasmCloud lattice integration
@wasmcloud/eslint-config	Shared ESLint configuration
@wasmcloud/prettier-config	Shared Prettier configuration
@wasmcloud/tsconfig	Shared TypeScript configuration

🚀 Applications

Application	Description
Washboard UI	Web-based dashboard for managing wasmCloud lattices

📚 Component Examples

Note

New to wasmCloud components in TypeScript?

Start with the wasmCloud TypeScript language guide

wasmCloud Components are WebAssembly components that serve as applications on the wasmCloud platform.

Example	Description
TypeScript Components	Sample wasmCloud components written in TypeScript

🧩 Project Templates

Project templates for scaffolding new wasmCloud component projects.

These templates can be used with wash new:

wash new https://github.com/wasmCloud/typescript.git --name my-project --subfolder templates/<template-name>

Template	Description
http-hello-world-hono	Minimal HTTP server component using Hono
http-hello-world-fetch	Minimal HTTP server component using the fetch() API
http-client	Component that makes outgoing HTTP requests
http-service-hono	HTTP service component powered by Hono
http-blobstore-service-hono	HTTP service component powered by Hono, backed by wasi:blobstore
http-kv-service-hono	HTTP service component powered by Hono, backed by wasi:keyvalue

See the templates README for more details.

🛠️ Development

For detailed development setup, workflow, and contribution guidelines, please see our Contributing Guide.

Quick Start

Install Yarn:

npm install -g yarn

Install dependencies:

yarn install

Build all packages:

yarn build

Run development servers:

yarn dev

Monorepo Structure

This repository uses:

• Yarn Workspaces for dependency management
• Turbo for build orchestration and caching
• Changesets for version management and publishing

📖 Documentation

• wasmCloud Documentation - Official wasmCloud documentation
• wasmCloud TypeScript Guide - TypeScript-specific wasmCloud development guide
• Contributing Guide - How to contribute to this repository

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Development setup and workflow
• Code style and standards
• Testing requirements
• Commit conventions
• Pull request process

📄 License

This project is licensed under the Apache 2.0 License.

🔗 Related

• wasmCloud - The main wasmCloud runtime
• wasmCloud Documentation - Comprehensive guides and API reference
• WebAssembly Component Model - The foundation for wasmCloud components