# Suggested Commands for Quixotic Development

## Development Commands
- `yarn install` - Install project dependencies
- `yarn dev` - Start development server with nodemon (auto-restart)
- `yarn start` - Start production server

## System Requirements
- **FFmpeg Installation**:
  - macOS: `brew install ffmpeg`
  - Ubuntu/Debian: `sudo apt install ffmpeg`
  - Windows: Download from ffmpeg.org

## Environment Setup
- `cp .env.example .env` - Create environment configuration file
- Edit `.env` file with required values:
  - `TELEGRAM_BOT_TOKEN=your_bot_token_here`
  - `WEB_APP_URL=https://your-domain.com`
  - `PORT=3000`

## Git Commands (Darwin System)
- `git status` - Check repository status
- `git add .` - Stage all changes
- `git commit -m "message"` - Commit changes
- `git push` - Push to remote repository

## File System Commands (macOS/Darwin)
- `ls -la` - List files with details
- `find . -name "*.js"` - Find JavaScript files
- `grep -r "text" .` - Search for text in files
- `cd directory` - Change directory
- `mkdir directory` - Create directory
- `rm -rf directory` - Remove directory recursively

## Database Management
- SQLite database files are in `database/` directory
- No dedicated database management commands configured
- Database is automatically initialized on first run

## Process Management (Production)
- `pm2 start src/server.js --name quixotic` - Start with PM2
- `pm2 logs quixotic` - View logs
- `pm2 restart quixotic` - Restart application
- `pm2 stop quixotic` - Stop application

## Health Check
- Visit `http://localhost:3000/health` - Check if server is running
- Check server logs for errors

## Port Information
- Default port: 3000 (configurable via PORT environment variable)
- Development server runs on same port as production