StackOne - Examples

Official code examples showing how to integrate with the StackOne Integration Gateway to develop integrated agents.

This repository contains minimal, production-oriented examples for common StackOne use cases.

This repo is for:

• Developers evaluating StackOne
• Customers building their first integration
• Reference implementations for specific integration flows

This repo is not:

• A full SDK
• A framework or boilerplate
• An exhaustive API reference

Examples included

• OAuth Redirect Proxy - A custom domain proxy for OAuth redirects that forwards callbacks to StackOne, solving the need for verified domains in OAuth app configurations
• Context-Aware Agent Playground - A context-aware agent playground implementation using RAG (Retrieval-Augmented Generation), realtime StackOne actions & webhooks for efficient RAG re-indexing

Languages

• TypeScript - All examples are written in TypeScript
• JavaScript/Node.js - Runtime environment for all examples

Repository structure

examples/
├── apps/ # Example applications
│ ├── oauth-redirect-proxy/ # OAuth redirect proxy example
│ └── rag-knowledge-agent/ # Context-Aware Agent Playground
├── packages/ # Shared configuration packages
│ ├── eslint-config/ # Shared ESLint configurations
│ └── typescript-config/ # Shared TypeScript configurations
├── package.json # Root package.json (Turborepo config)
└── turbo.json # Turborepo task configuration

This repository uses Turborepo for monorepo management. Each app is independent but shares build tooling and can be managed from the root.

Prerequisites

• Node.js >= 18 (see engines in package.json)
• npm >= 10.9.2 (or compatible package manager)
• StackOne account - Sign up at stackone.com to get your API credentials

Getting Started

Option 1: Using Turborepo (Recommended)

From the repository root:

# Install all dependencies
npm install
# Run all apps in development mode
npm run dev
# Build all apps
npm run build
# Lint all apps
npm run lint

Option 2: Run Individual Apps

You can still run commands from individual app directories:

cd apps/rag-knowledge-agent
npm install
npm run dev

Or use Turborepo to run a specific app:

# From root directory
turbo run dev --filter=rag-knowledge-agent
turbo run build --filter=oauth-redirect-proxy

Related documentation

• StackOne Documentation - Complete API reference and integration guides
• StackOne Integration Gateway - Learn more about StackOne's platform
• OAuth Proxy Redirect Guide - Detailed guide for OAuth redirect proxy setup