Skip to content

Build Zalo Mini Apps - lightweight web apps running inside the Zalo super-app platform.

Notifications You must be signed in to change notification settings

suminhthanh/zalo-mini-app-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Zalo Mini App Skill

Build Zalo Mini Apps - lightweight web apps running inside the Zalo super-app platform.

Features

  • ZaUI Components - Button, Input, Modal, Tabs, Avatar, Calendar, List, and 50+ more
  • JavaScript APIs - authorize, getUserInfo, getPhoneNumber, getLocation, Storage, Camera
  • Checkout SDK - Payment integration for Vietnamese market
  • Design Guidelines - Colors, typography, spacing, icons following Zalo standards
  • Development Tools - zmp-cli, VSCode extension, debugging

Installation

Option 1: Using add-skill CLI (Recommended)

# Install to current project
npx add-skill suminhthanh/zalo-mini-app-skills

# Install globally
npx add-skill suminhthanh/zalo-mini-app-skills -g

# Install for specific agent
npx add-skill suminhthanh/zalo-mini-app-skills -a claude-code

Option 2: Manual Installation

For Claude Code:

# Clone to Claude Code skills directory
git clone https://github.com/suminhthanh/zalo-mini-app-skills.git
cp -r zalo-mini-app-skills/skills/zalo-mini-app ~/.claude/skills/

For Project-level:

mkdir -p .claude/skills
cp -r zalo-mini-app-skills/skills/zalo-mini-app .claude/skills/

Option 3: Direct Download

# Download and extract
curl -L https://github.com/suminhthanh/zalo-mini-app-skills/archive/main.zip -o skill.zip
unzip skill.zip
cp -r zalo-mini-app-skills-main/skills/zalo-mini-app ~/.claude/skills/

Supported Agents

Agent Skills Directory
Claude Code ~/.claude/skills/ or .claude/skills/
Cursor ~/.cursor/skills/ or .cursor/skills/
OpenCode ~/.opencode/skill/
GitHub Copilot .github/copilot/skills/
Windsurf ~/.windsurf/skills/

Usage

Once installed, the skill activates automatically when you:

  • Build new Zalo Mini Apps
  • Use ZaUI components
  • Call Zalo SDK APIs
  • Integrate payments with Checkout SDK
  • Follow Zalo design guidelines

Quick Start

npm install -g zmp-cli
zmp create my-app && cd my-app && zmp start

Example Prompts

  • "Create a Zalo Mini App with bottom navigation"
  • "Add user authentication using Zalo authorize API"
  • "Implement a product list with ZaUI components"
  • "Integrate Checkout SDK for payment"

Skill Structure

zalo-mini-app/
├── SKILL.md                    # Main skill file
└── references/
    ├── getting-started.md      # Setup & deployment
    ├── api-overview.md         # API categories
    ├── api-user.md             # User APIs
    ├── api-storage.md          # Storage APIs
    ├── api-ui.md               # UI APIs
    ├── api-device.md           # Device APIs
    ├── api-zalo.md             # Zalo integration
    ├── zaui-overview.md        # Components overview
    ├── zaui-layout.md          # Layout components
    ├── zaui-display.md         # Display components
    ├── zaui-form.md            # Form components
    ├── zaui-overlay.md         # Overlay components
    ├── design-guidelines.md    # Design standards
    ├── web-design-guidelines.md # Accessibility, forms, animations, touch, i18n
    └── react-best-practices.md # Waterfalls, bundle size, re-renders, JS performance

Related Projects

zca-cli - Zalo CLI for Developers

zca-cli

A powerful command-line interface for the Zalo messaging platform. Automate messaging, manage groups, and build custom integrations directly from your terminal.

Features:

  • QR code login with multi-account support
  • Send text, images, videos, voice messages, and stickers
  • Group management (create, rename, add/remove members)
  • Real-time message listener with webhook integration
  • Batch operations and URL download support

Quick Install:

# macOS / Linux
curl -fsSL https://get.zca-cli.dev/install.sh | bash

# Windows (PowerShell)
irm https://get.zca-cli.dev/install.ps1 | iex

Website

Clawdbot - AI Agent with Zalo Integration

Clawdbot

A powerful agentic AI assistant with multi-channel messaging support. The Zalo User channel uses zca-cli under the hood to automate personal Zalo accounts.

Features:

  • Uses zca listen for receiving messages and zca msg for replies
  • Text, media, and link messaging support
  • Access control with pairing mode, allowlist, and group policies
  • Multi-account support via zca profiles
  • WebSocket gateway with tool execution and session management

Documentation | Website

Resources

License

MIT

About

Build Zalo Mini Apps - lightweight web apps running inside the Zalo super-app platform.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published