Appearance
Build
Complete guide for creating, building, and deploying Noorle plugins using WebAssembly and the Component Model.
📚 Documentation Structure
Getting Started
Learn the fundamentals and build your first plugin
- Quick Start - Build a plugin in 5 minutes
- Configuration - noorle.yaml and permissions
Plugin Development
Understand the platform and development patterns
- Platform Overview - Understanding the Noorle plugin platform
- When to Build Plugins - Deciding when custom plugins are needed
- Project Structure - Understanding plugin project layout
Language Guides
Language-specific implementation details
- Python - Rapid development with familiar syntax
- TypeScript - Type-safe JavaScript development
- JavaScript - Quick prototyping and flexibility
- Go - Simple syntax with great performance
- Rust - Maximum performance and safety
Deployment
Publishing and managing your plugins
- Publishing & Versioning - Deploy plugins to the platform
- Version Management - Semantic versioning and updates
🚀 Quick Start
1. Install CLI
bash
curl -L cli.noorle.dev | sh
2. Create Plugin
bash
noorle plugin init my-plugin --template python
cd my-plugin
3. Build & Deploy
bash
noorle plugin publish
🎯 Key Concepts
Universal Components
- No vendor lock-in - Standard WebAssembly components work everywhere
- Auto-discovery - Functions automatically exposed as MCP tools
- Language freedom - Use any language that compiles to WebAssembly
Component Model Benefits
- Type safety - Strong typing across language boundaries
- Security - Capability-based permissions
- Composability - Combine components from different sources
- Performance - Near-native execution speed
📖 Navigation Guide
For Beginners
- Start with Quick Start
- Learn about WebAssembly
- Choose your Language Guide
- Learn about Versioning
For Experienced Developers
- WebAssembly - Technical deep dive
- Configuration - Advanced permissions
- Versioning - Version management
By Programming Language
- Rust Developers → Rust Guide
- Python Developers → Python Guide
- TypeScript Developers → TypeScript Guide
- JavaScript Developers → JavaScript Guide
- Go Developers → Go Guide
🛠 Common Tasks
Create a New Plugin
bash
noorle plugin init my-plugin --template python
Install Dependencies
bash
noorle plugin prepare
Build Your Plugin
bash
noorle plugin build
Test Locally
bash
wasmtime run dist/plugin.wasm --invoke process "test"
Deploy to Platform
bash
noorle plugin deploy
💡 Plugin Ideas
Start with these plugin types:
API Wrappers
- Weather data fetcher
- Stock price monitor
- News aggregator
- Translation service
Data Processors
- JSON validator
- Markdown converter
- CSV parser
- XML transformer
Utilities
- Text formatter
- URL shortener
- Hash generator
- Time zone converter
Domain-Specific
- Scientific calculator
- Unit converter
- Regex matcher
- Color palette generator
🔧 Development Workflow
- Initialize - Create from template
- Prepare - Install dependencies
- Develop - Write your code
- Build - Compile to WebAssembly
- Test - Verify locally
- Deploy - Publish to Noorle
📋 Prerequisites
Required Tools
- Noorle CLI - Plugin management
- Language toolchain - Python/Node/Go
- WebAssembly tools - Installed by prepare script
Platform Requirements
- macOS or Linux
- Internet connection for deployment
- Noorle account for publishing
🆘 Getting Help
Documentation
- This build guide
- Language-specific guides
- Noorle Platform Docs
Resources
Community
- Report issues on GitHub
- Check template repositories
- Join community discussions
🎉 Ready to Build?
Choose your path:
- Quick Start - Jump right in
- WebAssembly - Understand the technology
- Language Guide - Deep dive into your language
Happy plugin building! 🚀