--- name: uniapp-uview description: A comprehensive skill for integrating and using uView UI with UniApp projects. This skill focuses on UniApp-specific integration, configuration, and platform-specific considerations when using uView UI in UniApp applications. Use this skill whenever the user needs to integrate uView UI into UniApp projects, configure UniApp-specific settings, or handle platform differences. license: Complete terms in LICENSE.txt --- ## When to use this skill Use this skill whenever the user wants to: - Integrate uView UI into UniApp projects - Configure UniApp projects to work with uView UI (pages.json, manifest.json, easycom) - Handle platform-specific behaviors when using uView in UniApp (H5, mini-program, App, nvue) - Use UniApp features (navigation, APIs, lifecycle) with uView components - Build cross-platform UniApp applications with uView UI components - Configure easycom for automatic uView component import in UniApp - Handle navigation and routing with uView in UniApp - Optimize UniApp projects using uView UI - Deploy uView-based UniApp applications to multiple platforms ## How to use this skill This skill is organized to match UniApp integration patterns and the official UniApp plugin structure (https://ext.dcloud.net.cn/plugin?id=1593). When working with uView UI in UniApp: 1. **Install and setup** uView UI in UniApp project: - Load `examples/getting-started/installation.md` for installation in UniApp - Load `examples/getting-started/project-setup.md` for UniApp project configuration - Load `examples/getting-started/easycom-config.md` for easycom configuration 2. **Integrate with UniApp features**: - Load `examples/integration/pages-config.md` for pages.json configuration - Load `examples/integration/manifest-config.md` for manifest.json configuration - Load `examples/integration/navigation.md` for navigation with uView - Load `examples/integration/uni-api.md` for using UniApp APIs with uView 3. **Handle platform-specific behaviors**: - Load `examples/platform-specific/h5.md` for H5 platform considerations - Load `examples/platform-specific/miniprogram.md` for mini-program considerations - Load `examples/platform-specific/app.md` for App platform considerations - Load `examples/platform-specific/nvue.md` for nvue considerations 4. **Advanced integration**: - Load `examples/advanced/custom-theme.md` for theme customization in UniApp - Load `examples/advanced/build-optimization.md` for build optimization - Load `examples/advanced/multi-platform.md` for multi-platform deployment 5. **Reference the API documentation** when needed: - `api/integration-api.md` - UniApp and uView integration API - `api/config-api.md` - Configuration API reference 6. **Use templates** for quick start: - `templates/basic-uniapp-project.md` - Basic UniApp project with uView - `templates/pages-template.md` - Pages configuration template - `templates/manifest-template.md` - Manifest configuration template **Important Notes**: - This skill focuses on UniApp integration, not uView UI API documentation - uView UI supports both Vue 2 and Vue 3, use appropriate syntax - Always configure easycom in pages.json for automatic component import - Use conditional compilation (`#ifdef`, `#endif`) for platform-specific code - Test on all target platforms (H5, mini-programs, App) before deployment - Use rpx units for responsive sizing in UniApp ## Examples and Templates ### Getting Started - **Installation**: `examples/getting-started/installation.md` - How to install uView UI in UniApp projects - **Project Setup**: `examples/getting-started/project-setup.md` - Setting up UniApp project with uView - **Easycom Config**: `examples/getting-started/easycom-config.md` - Configuring easycom for automatic component import ### Integration - **Pages Config**: `examples/integration/pages-config.md` - Configuring pages.json with uView - **Manifest Config**: `examples/integration/manifest-config.md` - Configuring manifest.json for uView - **Navigation**: `examples/integration/navigation.md` - Navigation and routing with uView - **UniApp API**: `examples/integration/uni-api.md` - Using UniApp APIs with uView components ### Platform-Specific - **H5**: `examples/platform-specific/h5.md` - H5 platform considerations with uView - **Mini-Program**: `examples/platform-specific/miniprogram.md` - Mini-program considerations with uView - **App**: `examples/platform-specific/app.md` - App platform considerations with uView - **nvue**: `examples/platform-specific/nvue.md` - nvue considerations with uView ### Advanced - **Custom Theme**: `examples/advanced/custom-theme.md` - Customizing themes in UniApp projects - **Build Optimization**: `examples/advanced/build-optimization.md` - Optimizing UniApp builds with uView - **Multi-Platform**: `examples/advanced/multi-platform.md` - Multi-platform deployment strategies ### Templates - **Basic Project**: `templates/basic-uniapp-project.md` - Basic UniApp project structure with uView - **Pages Template**: `templates/pages-template.md` - pages.json configuration template - **Manifest Template**: `templates/manifest-template.md` - manifest.json configuration template ## API Reference - **Integration API**: `api/integration-api.md` - UniApp and uView integration API reference - **Config API**: `api/config-api.md` - Configuration API reference for UniApp projects ## Best Practices 1. **Use easycom**: Configure easycom in pages.json for automatic uView component import 2. **Platform Testing**: Test on all target platforms (H5, mini-programs, App) 3. **Use rpx Units**: Use rpx for responsive sizing in UniApp, px for fixed sizes 4. **SCSS Support**: Ensure SCSS is properly configured in UniApp project 5. **Manifest Configuration**: Properly configure manifest.json for each platform 6. **Conditional Compilation**: Use conditional compilation for platform-specific code 7. **Performance**: Optimize for each platform's specific requirements 8. **Navigation**: Use UniApp navigation API with uView components ## Resources - **Official Plugin**: https://ext.dcloud.net.cn/plugin?id=1593 - **UniApp Documentation**: https://uniapp.dcloud.net.cn/ - **uView UI**: https://www.uviewui.com/ ## Keywords uniapp, uview, uview-ui, uniapp integration, uniapp configuration, easycom, pages.json, manifest.json, uni-app, 小程序, 跨平台, H5, App, nvue, 条件编译, 平台差异