mirror of
https://github.com/johndoe6345789/metabuilder.git
synced 2026-04-25 14:25:02 +00:00
johndoe6345789
b3e17e7dd4
- Created a new troubleshooting guide in README.md for common issues and testing problems. - Updated package.json to include new act commands for linting, type checking, building, and diagnosing workflows. - Added a pre-commit hook script to validate workflows before commits. - Enhanced run-act.sh script with logging, Docker checks, and improved output formatting. - Improved test-workflows.sh with an interactive menu and performance tracking. - Introduced setup-act.sh for quick setup and testing of act integration.
32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# Packages Documentation
|
|
|
|
The package system enables self-contained, reusable modules with their own components, scripts, and configuration.
|
|
|
|
## Package Structure
|
|
|
|
Each package follows a standard structure:
|
|
|
|
```
|
|
packages/{name}/
|
|
├── seed/
|
|
│ ├── metadata.json # Package info, exports, dependencies
|
|
│ ├── components.json # Component definitions
|
|
│ ├── scripts/ # Lua scripts organized by function
|
|
│ └── index.ts # Exports packageSeed object
|
|
├── src/ # Optional React components
|
|
└── static_content/ # Assets (images, etc.)
|
|
```
|
|
|
|
## Key Concepts
|
|
|
|
- **Self-contained** - Each package manages its own data and logic
|
|
- **Composable** - Packages can depend on other packages
|
|
- **Declarative** - Configuration in JSON, business logic in Lua
|
|
- **Exportable** - Packages can be shared and imported
|
|
|
|
## Related Resources
|
|
|
|
- [Architecture: Packages System](../architecture/packages.md)
|
|
- [Getting Started: Quick Start](../getting-started/QUICK_START.md)
|
|
- [Development: Component Development](../guides/component-development.md)
|