Tools & Workflows

Apso provides tools for building, testing, evolving, and deploying generated backend services. This page is for developers and AI-assisted builders who need the practical loop, not just a list of commands.

Recommended Loop

1. apso init creates or links the service project.
2. .apsorc captures the domain model.
3. apso generate turns the schema into framework code.
4. apso migrate checks schema changes before they reach a real database.
5. apso dev runs the service locally while you add extension logic.

Core Tools

Development Workflows

Quick Reference

CLI Commands

# Authentication
apso login              # Authenticate with Apso Cloud
apso logout             # Clear credentials
 
# Project Management
apso init --name my-api  # Create a new project
apso generate            # Generate code from .apsorc
 
# Development
apso migrate             # Test schema changes locally
apso dev                 # Start development server

SDK Usage

import { ApsoClient } from '@apso/sdk'
 
const client = new ApsoClient({
  baseUrl: 'http://localhost:3000'
})
 
// Query data
const projects = await client.projects.findMany()
 
// Create record
const newProject = await client.projects.create({
  name: 'My Project'
})

Recommended Workflow

1. Create project: apso init --name my-api
2. Define schema: Edit .apsorc with your entities
3. Generate code: apso generate
4. Check migrations: apso migrate
5. Start developing: apso dev
6. Test changes: Use SDK or REST client
7. Iterate: Modify schema, regenerate, migrate