Skip to content

PitcherAG/pitcher-app-tutorials

Repository files navigation

Pitcher API Tutorial: Building Your First Apps

This repository contains example code samples for developers building their first applications with the Pitcher API.

Getting Started

These examples demonstrate common usage patterns for the Pitcher API, from basic "Hello World" applications to more complex entity interactions and Salesforce integrations.

API Documentation

Full API documentation is available at: Pitcher API Documentation

Examples

Hello World Examples

Basic examples showing how to initialize a Pitcher app in different contexts:

  • Standalone: Simple independent application
  • Admin: Example for admin panel integration
  • Canvas: Embedded within Canvas UI

Entity Examples

Examples demonstrating how to work with Pitcher entities:

  • Standalone: Working with entities in standalone mode

Salesforce Integration

Examples showing how to integrate with Salesforce:

  • Standalone: Salesforce integration in standalone mode

Project Structure

Each example includes:

  • app.json: Configuration file for the application
  • dist/: Distribution folder containing the built application
    • index.html: Main entry point for the application
    • thumbnail.webp: Preview image
    • README.md: Example-specific documentation

Development Guide

Important: Developers should change the app identifier (name) field in the app.json file before publishing their applications.

Publishing Apps

Using Pitcher CLI

You can easily publish your Pitcher apps using the @pitcher/cli-scripts package. This tool simplifies the process of building, validating, and publishing your applications.

  1. Install the CLI tool:

    npm install -g @pitcher/cli-scripts

    This installs the p command line tool.

  2. Navigate to your app directory (containing app.json)

  3. Publish your app:

    p publish-app --api-key [YOURAPIKEY] --increment-version --org [YOURORG]

    Where YOURORG is your organization's specific subdomain. E.g. YOURORG.my.pitcher.com and YOURAPIKEY is your generated API key from YOURORG.my.pitcher.com/admin

For detailed information about all available commands and options, visit: Pitcher CLI Documentation

Additional Resources

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •