Frontal CLI

The Frontal CLI is the primary developer interface to the Frontal platform. It's built for speed, reliability, and an excellent developer experience.

Features

• 🔐 Authentication: Easy login/logout flow.
• 📁 Workspaces: Manage and switch between your team's workspaces.
• 🚀 Projects: List and create projects.
• 🛠️ Modern Stack: Built with TypeScript, Node.js/Bun, and Commander.
• ⚡ Fast: Optimized builds with tsup.

Installation

# Using npm
npm install -g @frontal/cli

# Using bun
bun install -g @frontal/cli

# Using pnpm
pnpm add -g @frontal/cli

Basic Usage

# Show version
frontal --version

# Show help
frontal --help

# Login to Frontal
frontal auth login

# List projects
frontal projects list

# Switch workspace
frontal workspaces use <id>

Commands

• auth login | logout | whoami
• projects list | create <name>
• workspaces list | use <id>

Architecture

The CLI is designed with a clean, decoupled architecture:

• src/index.ts: Entry point.
• src/commands/: Command definitions.
• src/core/: Logger and CLI context.
• src/api/: API client (currently stubbed).
• src/config/: Configuration management using ~/.frontal.

Development

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build for production
bun run build

# Lint and format
bun run lint
bun run format

License

MIT