lark-apps

Deploy local HTML files or directories to Feishu Miaoda as publicly accessible apps with shareable URLs.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/sliec/shared-files --skill lark-apps-sliec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-apps
Source: https://github.com/sliec/shared-files/tree/main/skills/lark-apps
Command: npx skills add https://github.com/sliec/shared-files --skill lark-apps-sliec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Publishing a local HTML page, static site, or web demo so others can access it normally requires servers, hosting, and manual configuration. This Skill deploys local HTML artifacts to Feishu Miaoda and returns a public access URL, with optional access-scope control. ## Core Features & Use Cases - HTML Publishing: Deploy a single HTML file or an entire directory (e.g., ./dist) as a Miaoda app and get back a shareable URL. - App Lifecycle Management: Create new Miaoda apps and update their name or description via lark-cli shortcuts. - Access Scope Control: Set visibility to specific users/departments/chats, tenant-wide, or public internet with optional login requirement. - Use Case: You built an HTML slide deck or survey page locally. Use this Skill to create a Miaoda app, publish the directory, set it to tenant-wide visibility, and share the returned link with colleagues. ## Quick Start Deploy the HTML site in my ./dist folder to Feishu Miaoda and give me the shareable link.

Frequently Asked Questions about lark-apps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a local HTML file to Feishu Miaoda?

Create an app with lark-cli apps +create --name "<name>" --app-type HTML, then run lark-cli apps +html-publish --app-id <id> --path <file-or-directory>. The response returns a public URL for the deployed app.

How do I publish a static website directory as a shareable link?

Pass the directory path to apps +html-publish, which recursively packages it as tar.gz and deploys it. The directory must contain index.html at its root, and you should use a clean build output like ./dist to avoid packing .git or node_modules.

Why does Miaoda HTML publish fail with credential file errors?

The Validate stage scans the publish path for credential files such as .env, .npmrc, .netrc, .git-credentials, and cloud SDK configs, and exits non-zero on any hit. Remove those files from the payload, or pass --allow-sensitive only when shipping them is intentional.

How do I control who can access a Miaoda app?

Use apps +access-scope-set with one of three mutually exclusive scopes: specific (requires --targets JSON of users, departments, or chats), public (requires --require-login), or tenant (no extra flags). Check current settings with apps +access-scope-get.

What file naming requirements does Miaoda HTML publishing have?

The entry file must be named index.html. For directories, index.html must sit at the root; for single-file publishes, the file itself must be named index.html. Names like app.html or demo.html are rejected by +html-publish.

Can I reuse an existing Miaoda app instead of creating a new one?

Yes, but you must supply the app_id yourself, either directly as an app_xxx string or extracted from a Miaoda app URL like https://miaoda.feishu.cn/app/app_xxx. The agent does not search or enumerate existing apps; the default behavior is creating a new one.