ASC App Packaging
Create manifests that make an app installable via asc install <name>.
Root rule (important)
A repository may contain many asc.yaml files in subdirectories, but its root must contain exactly one manifest: either asc.yaml (single app) or asc.stack.yaml (stack connecting the nested apps). Nested manifests without a root one are not indexed.
Single app: asc.yaml
name: my-app # kebab-case, unique in the registry
version: 1.2.0 # semver
type: docker # docker | native | utility
category: web # databases | ai | bots | game-servers | system-utilities | web
description: "Short English description"
runtime:
image: nginx:1.27 # for docker; native/utility use install/start/stop commands
env:
- name: PORT
default: 8080
- name: API_KEY
secret: true
required: true
ports: [8080]
volumes: [/data]
requirements: { ram: 256M, disk: 1G }
healthcheck: { http: /health }
Multi-app stack: asc.stack.yaml
name: my-stack
version: 1.0.0
description: "Web app with database"
apps:
- name: web
path: ./web # directory containing its own asc.yaml
depends_on: [db]
- name: db
path: ./db
env: # shared across all stack apps
- name: TZ
default: UTC
Install: asc install my-stack (whole stack) or asc install my-stack/web (one app).
Workflow
- Ask what the app is (docker image? native binary? multiple components?) and pick
asc.yamlvsasc.stack.yaml. - Write the manifest(s). Descriptions in English for public registries.
- Validate against JSON schemas from the official registry repo:
schema/asc.schema.json,schema/asc.stack.schema.json(https://github.com/AdminServiceCloud/registry). - Test locally:
asc source add file:///path/to/repo && asc install <name>(see asc-server-management skill ifascis missing). - Publish: PR to the official registry (add an entry to the matching
categories/<theme>.json, English description, typeapporstack) or just share the GitHub repo URL — users can add it withasc source add.
Tips
- Mark tokens/passwords with
secret: trueso the platform stores and masks them properly. - Examples live in https://github.com/AdminServiceCloud/asc-example-apps.