Spaces:
Running
Running
File size: 2,360 Bytes
10d1fd4 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 | # Development Commands
## Build & Development
- **`docker compose up`**: Start development server with HMR on port 7861
- **`docker compose up --build`**: Compile for production
- **`docker compose exec development-server npm run start`**: Preview production build
- **`docker compose exec development-server npm run lint`**: Check code quality (Biome, TypeScript, dependencies)
- **`docker compose exec development-server npm run format`**: Auto-format code with Biome
## Docker
- **`docker compose up`**: Development environment with SearXNG, llama-server, and Node.js
- **`docker compose -f docker-compose.production.yml up --build`**: Production deployment
## Testing
- **`docker compose exec development-server npm run test`**: Run Vitest tests
- **`docker compose exec development-server npm run test:ui`**: Run tests with UI
- **`docker compose exec development-server npm run test:coverage`**: Run tests with coverage report
### Coverage Reports for AI Analysis
After running `test:coverage`, AI agents can analyze these JSON files:
- **`coverage/coverage-summary.json`**: Quick metrics view - overall percentages per file
```json
{
"total": {
"lines": { "total": 100, "covered": 85, "pct": 85 },
"statements": { "total": 120, "covered": 100, "pct": 83.33 },
"functions": { "total": 30, "covered": 25, "pct": 83.33 },
"branches": { "total": 50, "covered": 40, "pct": 80 }
},
"/path/to/file.ts": { ... }
}
```
- **`coverage/coverage-final.json`**: Detailed per-file coverage with line-by-line mapping
- Use this to identify specific uncovered lines, branches, and functions
- Maps statement/branch/function IDs to source locations
AI agents can parse these to identify:
- Files with coverage below thresholds
- Uncovered lines and branches
- Functions without tests
- Coverage gaps across the codebase
## Quality Assurance
- **`docker compose exec development-server npm run lint`**: Biome linting, TypeScript checking, and dependency validation
- **`docker compose exec development-server npm run format`**: Format code with Biome (enforced via pre-commit hooks)
## Related Topics
- **Quick Start**: `docs/quick-start.md` - Installation and first run
- **Configuration**: `docs/configuration.md` - Environment variables
- **Pull Requests**: `docs/pull-requests.md` - Contribution workflow
|