Quick Start

Prerequisites

Before you begin, ensure your environment meets the following requirements:

• Node.js 18.0 or later
• npm 9+ or pnpm 8+
• A valid #divisions API key (generate one here)
• Basic familiarity with terminal commands

1. Install the CLI

The #divisions CLI is the primary tool for managing projects, deployments, and monitoring. Install it globally using npm:

Verify the installation by checking the version:

2. Initialize a Project

Create a new project directory and scaffold the default structure. The CLI will prompt you for project metadata:

This generates:

• divisions.yaml - Core configuration
• .env.example - Environment template
• src/ - Application entry point
• package.json - Dependencies & scripts

3. Configure Environment

Copy the example environment file and add your API key. This step connects your local environment to the #divisions platform:

Edit divisions.yaml to set your runtime preferences:

4. Deploy & Verify

Run the deploy command. The CLI will bundle your assets, upload them to the edge network, and provision your environment:

Monitor real-time logs directly from your terminal:

Troubleshooting

Common Issues

• Authentication Failed: Verify your API key has the deploy:write permission scope.
• Build Timeout: Increase build_timeout in divisions.yaml if your project uses heavy dependencies.
• Port Conflicts: The dev server uses port 3000 by default. Override with --port 3001.

For advanced debugging, enable verbose logging:

Next Steps

Your application is now live. Explore these resources to scale your workflow: