uni-helper_skill

Overview

This skill is a comprehensive reference for the uni-helper ecosystem, covering Vite plugins, libraries, utilities, and project starters tailored for uni-app. It summarizes features, best practices, and quick-start guidance to accelerate uni-app development with TypeScript and Vite. The content focuses on practical tooling like file-based routing, auto component imports, platform compilation, and TypeScript-friendly utilities. It is ideal for developers adopting uni-app with modern build tooling.

How this skill works

The skill inspects and catalogs uni-helper modules such as Vite plugins (pages, layouts, components, manifest, platform, middleware) and utility libraries (uni-use, uni-network, uni-promises, uni-typed). It highlights recommended plugin load order, integration patterns, and starter templates to scaffold projects quickly. It also points to environment utilities and CSS presets for consistent styling and platform detection. Use it as a concise reference to choose and configure the right uni-helper pieces for your project.

When to use it

• Starting a new uni-app project and you want a Vite-first, TypeScript-ready setup.
• Implementing file-based routing, layouts, or automatic component imports in uni-app.
• Targeting multiple platforms (H5, mini-programs, native app) with platform-specific compilation.
• Adding promise-based uni-app APIs, network client, or TypeScript template typings.
• Standardizing plugin order and middleware behavior across team projects.

Best practices

• Follow the recommended Vite plugin order to avoid resolution and compilation conflicts.
• Use create-uni or the vitesse-uni-app starter to get a Vite + TypeScript baseline quickly.
• Adopt uni-typed for template type safety and uni-promises for consistent async handling.
• Enable UniComponents for on-demand imports to reduce bundle size and simplify templates.
• Keep platform-specific files organized with UniPlatform and use UniPlatformModifier for attribute tweaks.

Example use cases

• Scaffold a new uni-app with create-uni and enable UniComponents, UniPages, and UniLayouts for rapid page and layout setup.
• Migrate an existing project to Vite and TypeScript using vite-plugin-uni-manifest and uni-typed to preserve manifest and template types.
• Build a multi-platform release where UniPlatform compiles platform entries and UniPlatformModifier adjusts directives per target.
• Implement global route guards with UniMiddleware while keeping component imports automatic and tree-shakable.
• Use uni-network and uni-promises together to centralize HTTP logic and convert callback APIs to Promise-based flows.