uniapp-mini-guide

When to use this skill

Use this skill whenever the user wants to:

• Build uni-app mini programs
• Configure mini program settings and capabilities
• Use mini program components and APIs within uni-app
• Understand native mini program limitations and compatibility

How to use this skill

1. Start with the overview:

   • examples/guide/intro.md

2. Configure mini program settings:

   • examples/guide/config.md

3. Check component and API references:

   • examples/components/overview.md
   • examples/api/overview.md

Examples and Templates

• examples/guide/intro.md - Mini program overview
• examples/guide/config.md - Configuration and capability setup
• examples/components/overview.md - Component references and usage
• examples/api/overview.md - API references and usage

Best Practices

1. Follow mini program platform requirements and audits
2. Keep package size small and optimize assets
3. Validate API compatibility per platform
4. Use conditional compilation for platform-specific code

Resources

• https://nativesupport.dcloud.net.cn/

Keywords

uniapp, uni-app, mini program, mini program, native support, components, api, platform compatibility

Capability Boundaries

✅ Applicable Scenarios

• When you need to use the technology stack corresponding to this skill
• When the project needs to follow best practices
• When you need to get started quickly or gain an in-depth understanding of core concepts

⚠️ Points to Note

• Complex business logic needs to be adjusted according to specific scenarios
• Performance optimization needs to be evaluated based on the actual data volume

❌ Inapplicable Scenarios

• Irrelevant technology stacks or frameworks
• Special scenarios that require full customization

Common Pitfalls (Gotchas)

1. Version Compatibility: Pay attention to the compatibility between the framework version and dependency libraries; APIs may differ across versions
2. Configuration File Format: Configuration file format errors are the most common issue; it is recommended to use the editor's syntax checking
3. Environment Variables: Ensure that all necessary environment variables are set correctly, and do not hard-code sensitive information
4. Dependency Conflicts: Pay attention to dependency conflicts when multiple versions coexist, and use a lock file to pin versions
5. Performance Pitfalls: Pay attention to performance optimization in large-data-volume scenarios, and avoid common issues such as N+1 queries

Usage Workflow

Step 1: Environment Preparation

Ensure that the necessary dependencies and tools are installed in the development environment.

Step 2: Configuration Initialization

Perform basic configuration according to project requirements.

Step 3: Using Core Features

Implement the core features according to the example code.

Step 4: Test Verification

Run tests to ensure the functionality works properly.

Step 5: Deployment and Launch

Deploy and monitor after development is completed.