App development process

Building apps on Rocketlane is a streamlined experience designed to empower developers to extend, integrate, and customize Rocketlane’s capabilities. This guide walks you through the complete app development lifecycle—from setup to submission.

Quick Start

• Install prerequisites
• Install RLI (Rocketlane CLI)
• Create your app
• Build your app
• Test your app
• Deploy to Rocketlane

Install Prerequisites

Rocketlane CLI (RLI) is a Node.js-based tool. You’ll need:

• Node.js v18.13.0 or later (install via Node Version Manager or directly)

Check your version:

node -v

Install the RLI CLI

Install the Rocketlane CLI globally using npm:

npm install -g @rocketlane/rli

Verify installation:

rli --version

Create an App

Initialize a new Rocketlane app project with:

rli init my-app-name

Options:

• -t, --template <string>: Choose a boilerplate (e.g., basic, react)
• -d, --dir <string>: Target directory for app files

This generates a scaffold with the following structure:

• index.js — the app manifest
• src/ — front-end source files
• public/ — icons and assets
• server/ — backend logic (optional)

Build the App

Your app logic is implemented across:

• App Index (index.js): Declare widgets, backend handlers, installation fields, scheduled actions, and event listeners
• Front-end code: Use Rocketlane placeholders to embed your UI across Accounts, Projects, and the Customer Portal
• Serverless handlers: Add backend logic using eventHandlers, scheduledActions, and Rocketlane’s SDK (r.kv, r.scheduler, r.logger, etc.)

Use:

rli build

Test the App

Run the local development server with:

rli dev

This allows you to:

• Preview widgets and UI components
• Test serverless functions with mocked events

Navigate to the target page in Rocketlane (with dev mode enabled) to validate the front-end experience.

Deploy the App

When you’re ready to deploy:

rli deploy

This pushes your built app to Rocketlane, making it available in your account or on the Marketplace (based on configuration).

App Development Checklist

Before submitting your app:

• Define installationFields for user-configurable settings
• Use r.installationParams to access those settings in backend logic
• Register scheduled jobs using r.scheduler.scheduleAppJobs()
• Use r.kv to persist state or counters
• Clean up with onAppUninstall if needed
• Test front-end rendering in all applicable placeholders
• Log useful messages with r.logger

Submit Your App

Marketplace submission (for public apps) is coming soon. For now, reach out to your Rocketlane partner contact to get your app reviewed and published.

For tutorials, examples, and the latest SDK updates, visit the Rocketlane Developer Portal.