create-promptline-app

Create AI-powered apps for the PromptLine Marketplace.

Quick Start

# Create a new app
npx promptlineapp my-app
cd my-app
npm run dev

Commands

Create a new app

npx promptlineapp my-app                  # Interactive setup
npx promptlineapp my-app --preset api     # API-only preset
npx promptlineapp my-app --yes            # Skip prompts, use defaults

Get an existing use case

Clone an existing PromptLine app from Git:

npx promptlineapp get https://github.com/promptline/claude-realestate.git
npx promptlineapp get [email protected]:promptline/menumind.git my-restaurant

Update dev files

Update SDK and dev tools in an existing project:

cd my-project
npx promptlineapp update

Push & build a package

Sync your code from GitHub and build a package on the PromptLine platform:

npx promptlineapp push \
  -u "[email protected]" \
  -m "password" \
  -P "package-uuid" \
  -t "ghp_xxx" \
  -r "https://github.com/org/repo" \
  -e prod

Push options:

| Flag | Description | |------|-------------| | -u, --user | PromptLine account email (required) | | -m, --mdp | PromptLine account password (required) | | -P, --package | Package ID, or set package_id in promptline.yaml | | -t, --token | GitHub PAT, or set GITHUB_TOKEN env var | | -r, --repo | GitHub repo URL (required) | | -b, --branch | Git branch (default: platform config) | | -e, --env | Environment: local, dev, prod (default: local) | | -f, --force | Force build even if up to date |

Local Development

1. Configure your endpoints

Open http://localhost:5173/_dev and add your PromptLine endpoints:

• Alias: name used in code (e.g., chatbot, traduction)
• URL: endpoint URL from Creator Studio
• API Key: your API key (sk_org_... or sk_ws_...)

Click "Check Health" to verify, then "Add Endpoint".

2. Use in your code

import { usePromptLine } from '@promptline/sdk'

function MyComponent() {
  const { execute, isConfigured } = usePromptLine('chatbot')

  const handleClick = async () => {
    const result = await execute({ text: 'Hello!' })
    console.log(result.response)
  }

  if (!isConfigured) {
    return <p>Configure 'chatbot' at <a href="/_dev">/_dev</a></p>
  }

  return <button onClick={handleClick}>Ask AI</button>
}

3. Multiple endpoints

const { execute: chat } = usePromptLine('chatbot')
const { execute: translate } = usePromptLine('traduction')

const chatResult = await chat({ text: 'Hello' })
const translatedResult = await translate({ text: 'Bonjour', target: 'en' })

Project Structure

my-app/
├── public/           # Public pages
├── private/          # Auth-protected pages
├── backend/          # Custom API (FastAPI)
├── dev/              # Local dev tools (not deployed)
│   ├── sdk-mock.jsx  # SDK for local testing
│   └── dev-admin.jsx # /_dev page
└── promptline.yaml   # App configuration

Presets

| Preset | Description | |--------|-------------| | full-app | Complete app with pages, dashboard & AI (default) | | api | Backend-focused, minimal frontend |

Deployment

1. Click "Download Manifest" in /_dev to get promptline.config.json
2. Upload your app to Creator Studio
3. Bind your endpoints and publish