Files
everforest-resources/.serena/memories/suggested-commands.md
Ismo Vuorinen 11baabe545 feat: initial scaffold and generator
- Complete project structure with directories for all target platforms
- Template system for CLI tools with color placeholder replacement
- Working generator that processes templates for 6 theme variants
- GitHub workflows for build, snapshots, commitlint, and cli-verify
- Installer and verifier scripts for CLI tool deployment
- Comprehensive documentation and specifications
- Biome 2.x linting and formatting setup
- Husky git hooks for pre-commit validation
2025-09-05 23:06:12 +03:00

2.6 KiB

Suggested Commands - Everforest Resources

Core Development Commands

Theme Generation

npm run generate          # Generate all theme files from palettes
node scripts/generate-themes.mjs  # Direct generator execution

Code Quality & Linting

npm run lint             # Check code with Biome linter
npm run lint:fix         # Auto-fix linting issues with Biome
npm run format           # Format code with Biome
npm run validate         # Validate generated outputs and structure
npm run ci               # Full CI suite: lint + generate + validate + snapshots

Testing

npm run snapshots        # Generate Playwright web snapshots
playwright test          # Direct Playwright execution

Git & Setup

npm run prepare          # Install Husky git hooks
npm install              # Install dependencies

Alternative Commands (Makefile - when implemented)

make generate            # Alternative to npm run generate
make validate            # Alternative to npm run validate
make ci                  # Alternative to npm run ci
make snapshots           # Generate web snapshots
make demo                # Run web demo server

Installation & Deployment

./cli/install.sh         # Deploy all configs to ~/.config (when implemented)
ENGINE=docker ./verify/verify.sh  # Verify in container (when implemented)

Development Workflow Commands

# 1. Edit palette or templates
vim palettes/everforest.json
vim cli/starship/template.txt

# 2. Lint and format code
npm run lint:fix         # Fix any linting issues
npm run format           # Ensure consistent formatting

# 3. Generate themes
npm run generate

# 4. Validate output
npm run validate

# 5. Test web components
npm run snapshots

# 6. Full CI check
npm run ci

# 7. Commit changes
git add -A
git commit -m "feat: update starship theme colors"

Biome Commands

biome check .            # Check all files for issues
biome check . --write    # Auto-fix issues
biome format . --write   # Format all supported files
biome lint .             # Lint JavaScript/TypeScript files

System Commands (macOS/Darwin)

# File operations
ls -la                   # List files with details
find . -name "*.mjs"     # Find JavaScript modules
grep -r "template" .     # Search for template references

# Directory navigation
pwd                      # Current directory
cd scripts/              # Change to scripts directory

# Git operations
git status               # Check git status
git log --oneline        # View commit history
git diff                 # View changes