This repository contains a collection of example ONES Apps that demonstrate how to build applications that extend and enhance the ONES platform. Each example focuses on different use cases, capabilities, and implementation patterns.

These examples serve as starter templates and learning resources for developers building ONES Apps.

More examples coming soon...

An automation app that demonstrates event-driven automation by automatically adding watchers to newly created issues.

Key Features:

• Event-driven automation (ones:project:issue:created)
• Settings page for rule configuration
• ONES OpenAPI integration
• JWT authentication
• SQLite database persistence

Technologies: NestJS, React, TypeScript, Vite, SQLite, TypeORM

View Documentation →

• Node.js >= 20.0.0
• npm >= 10.0.0

Install (recommended):

• macOS / Windows: download and install the LTS Node.js installer from https://nodejs.org/, or use a version manager:
  • fnm (Fast Node Manager) - cross-platform, fast
  • Volta - cross-platform, manages Node/npm/yarn
  • nvm (macOS/Linux) or nvm-windows (Windows)
• macOS (alternative): install via Homebrew: brew install node
• Linux: use your distro package manager or a version manager

Verify:

node -v
npm -v

When developing ONES Apps, you may need to expose your local server (e.g. localhost:3000) to the public internet. It the necessary let ONES platform access your local service.

Recommended: Cloudflare Tunnel (cloudflared)

# macOS (Homebrew)
brew install cloudflared

# Windows (winget)
winget install -e --id Cloudflare.cloudflared

Linux (Debian/Ubuntu/RHEL, etc.): see Cloudflare’s downloads/docs: https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/

Quick run:

cloudflared tunnel --url http://localhost:3000

See More: Expose Your App Service →

This project is licensed under the MIT License.

• ONES Developer Documentation
• ONES OpenPlatform Capabilities Reference
• ONES App Manifest Documentation

If you encounter any issues or have suggestions, please:

• Open an Issue
• See the main README for more information about this examples repository