# Suggested Development Commands

## Core Development Commands
```bash
# Install dependencies
npm install

# Start development server
npm run dev                    # Starts at localhost:4321

# Build for production
npm run build                  # Includes native Rust build
npm run build:native          # Build only Rust bindings
npm run preview               # Preview production build

# Astro CLI commands
npm run astro ...             # Run any Astro CLI command
npm run astro -- --help      # Get Astro CLI help
```

## System Utilities (Darwin/macOS)
```bash
# Basic file operations
ls                            # List files
cd <directory>                # Change directory
find . -name "*.ts"          # Find TypeScript files
grep -r "pattern" .          # Search for patterns

# Git operations
git status                    # Check git status
git add .                     # Stage all changes
git commit -m "message"       # Commit changes
git push                      # Push to remote

# Package management
npm install <package>         # Install new package
npm uninstall <package>       # Remove package
npm audit                     # Check for vulnerabilities
```

## Rust/NAPI Commands
```bash
# Native bindings
cargo build --release         # Build Rust code
napi build --platform --release  # Build NAPI bindings

# Rust development
cargo check                   # Check Rust code
cargo test                    # Run Rust tests
cargo clippy                  # Rust linter
```

## Testing & Quality (when available)
```bash
# Check if these exist in project:
npm run test                  # Run tests (if configured)
npm run lint                  # Lint code (if configured)
npm run format                # Format code (if configured)
npm run typecheck             # TypeScript checking (if configured)
```

## Debugging
```bash
# Development debugging
npm run dev -- --verbose     # Verbose development mode
npm run build -- --verbose   # Verbose build

# View logs
tail -f logs/app.log         # If logs exist
console logs via browser dev tools  # For frontend debugging
```