baro: Instructions file for Claude Code

CLAUDE.md

Project Overview

Baro is a dual-stack project combining Rust and TypeScript/Node.js. It appears to be a TUI (terminal user interface) application with an accompanying web/app component. The project uses Rust for core functionality and TypeScript for the application layer.

Tech Stack

• Rust: Core TUI application (baro-tui crate)
• TypeScript/Node.js: Main application layer (baro-app package)
• Cargo: Rust package manager and build system
• npm: Node.js package manager

Directory Structure

baro/
├── crates/              # Rust workspace
│   └── baro-tui/        # Main Rust TUI crate
│       ├── Cargo.toml
│       └── src/
├── packages/            # Node.js workspace
│   └── baro-app/        # Main application
│       ├── package.json
│       ├── src/
│       ├── bin/
│       ├── scripts/
│       └── tsconfig.json
├── .github/workflows/   # CI/CD pipelines
│   └── release.yml
├── Cargo.toml           # Root Rust workspace manifest
├── package.json         # Root Node.js manifest
├── Cargo.lock
├── package-lock.json
├── README.md
├── prd.json            # Product requirements document
└── assets/
    └── screenshot.png

Build Commands

Rust:

cargo build      # Build the Rust project
cargo test       # Run Rust tests

Node.js:

npm install      # Install dependencies
npm run [script] # Run scripts defined in package.json

Key Files

• Cargo.toml: Root Rust workspace configuration
• package.json: Root Node.js configuration
• crates/baro-tui/src/: Rust TUI implementation
• packages/baro-app/src/: TypeScript application source
• .github/workflows/release.yml: Release pipeline configuration
• prd.json: Product specifications and requirements

Development Conventions

• Uses Rust workspace for crate management (monorepo structure)
• Uses npm/Node.js workspace for package management
• Release workflow defined in GitHub Actions
• No linter or formatter configuration detected in scan (may exist but not documented)