98e2d4e783
Some checks failed
CI/CD Pipeline / Test Suite (push) Has been cancelled
CI/CD Pipeline / Security Audit (push) Has been cancelled
CI/CD Pipeline / Build Docker Image (push) Has been cancelled
CI/CD Pipeline / Deploy to Staging (push) Has been cancelled
CI/CD Pipeline / Deploy to Production (push) Has been cancelled
CI/CD Pipeline / Performance Benchmarks (push) Has been cancelled
CI/CD Pipeline / Cleanup (push) Has been cancelled
2.6 KiB
2.6 KiB
Rustelo Features Documentation
Available Features
Analytics
Comprehensive analytics system with navigation tracking, server monitoring, and browser analytics.
Installation:
cargo rustelo features add analytics
Provides:
- Navigation tracking with cache performance analysis
- Server log analysis and panic detection
- Browser console error tracking
- Real-time monitoring dashboard
- CLI tools for analysis and reporting
Configuration: config/analytics.toml
Smart Build
Incremental build system with intelligent caching and performance optimization.
Installation:
cargo rustelo features add smart-build
Provides:
- Multi-layer cache system (L1/L2/L3)
- Incremental builds with change detection
- Build performance optimization
- Cache management and cleanup tools
Configuration: config/smart-build.toml
Feature Development
Creating a New Feature
- Create feature directory:
mkdir features/my-feature
- Create feature manifest:
# features/my-feature/feature.toml
[feature]
name = "my-feature"
version = "0.1.0"
description = "My custom feature"
[dependencies]
workspace = ["serde", "tokio"]
external = []
- Add to features registry:
# registry/features.toml
[features.my-feature]
description = "My custom feature"
source = "local"
status = "available"
requires = []
Feature Manifest Sections
- feature: Basic metadata (name, version, description)
- dependencies: Workspace and external dependencies
- environment: Environment variables
- configuration: Configuration files to install/merge
- resources: Assets, content, and i18n files
- scripts: Development and automation scripts
- node: Node.js dependencies
- styles: UnoCSS presets and styling
- docker: Docker services and infrastructure
- just: Just command modules
Feature Integration Levels
- Dependencies: Cargo and Node.js dependencies
- Environment: Environment variables and secrets
- Configuration: TOML/JSON config file merging
- Resources: Public assets, site content, i18n files
- Styling: UnoCSS preset and theme integration
- Infrastructure: Docker services and deployment configs
- Development: Scripts, Just commands, git hooks
Best Practices
- Self-Contained: Features should be independent and removable
- Configurable: Use environment variables for customization
- Documented: Include clear documentation and examples
- Tested: Provide tests for feature functionality
- Versioned: Use semantic versioning for feature updates