Development Guide - larralapid/personal-backstage GitHub Wiki
Development Guide
๐ ๏ธ Project Structure
self-catalog/
โโโ packages/
โ โโโ app/ # Frontend React application
โ โโโ backend/ # Backend Node.js services
โโโ examples/ # Catalog configuration files
โ โโโ personal-infrastructure.yaml
โ โโโ data-templates.yaml
โ โโโ backlog-templates.yaml
โโโ test-*.js # Test suite files
โโโ docs/ # Documentation
Contributing to Your Setup
- Add New Projects: Edit
examples/personal-infrastructure.yaml
- Create Templates: Add to
examples/data-templates.yaml
- Update Config: Modify
app-config.yaml
- Test Changes: Run
node test-config.js
๐งช Testing
The project includes a comprehensive test suite:
# Run all tests
node run-all-tests.js
# Run specific test suites
node test-config.js # Configuration validation
node test-catalog-simple.js # Catalog relationships
node test-runtime.js # Application startup
๐ Current Status
- 80 Total Tests with 97.5% Pass Rate
- 28 Configuration Tests - All passing
- 48 Catalog Tests - All passing
- Full Frontend - Working perfectly
- Backend - Partial (native dependency issues)
๐ค Contributing
This is a personal project, but contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Run the test suite
- Submit a pull request