f831fd6846
- Move PHP and Go framework docs from /packages/ to /build/ - Move CLI docs from /packages/go/cmd/ to /build/cli/ - Add /publish/ section with docs for all release publishers: GitHub, Docker, npm, Homebrew, Scoop, AUR, Chocolatey, LinuxKit - Add sidebar navigation for /publish/ section - Update nav with Build, Publish, Deploy dropdowns - Remove changelog, contributing, guide, and security sections - Make sidebar auto-discover from packages, build, publish, deploy dirs Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
60 lines
No EOL
1.2 KiB
Markdown
60 lines
No EOL
1.2 KiB
Markdown
# Publish
|
|
|
|
Release your applications to package managers, container registries, and distribution platforms.
|
|
|
|
## Publishers
|
|
|
|
| Provider | Description |
|
|
|----------|-------------|
|
|
| [GitHub](./github) | GitHub Releases with assets |
|
|
| [Docker](./docker) | Container registries (Docker Hub, GHCR, ECR) |
|
|
| [npm](./npm) | npm registry for JavaScript packages |
|
|
| [Homebrew](./homebrew) | macOS/Linux package manager |
|
|
| [Scoop](./scoop) | Windows package manager |
|
|
| [AUR](./aur) | Arch User Repository |
|
|
| [Chocolatey](./chocolatey) | Windows package manager |
|
|
| [LinuxKit](./linuxkit) | Bootable Linux images |
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# 1. Build your artifacts
|
|
core build
|
|
|
|
# 2. Preview release (dry-run)
|
|
core ci
|
|
|
|
# 3. Publish (requires explicit flag)
|
|
core ci --we-are-go-for-launch
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Publishers are configured in `.core/release.yaml`:
|
|
|
|
```yaml
|
|
version: 1
|
|
|
|
project:
|
|
name: myapp
|
|
repository: org/myapp
|
|
|
|
publishers:
|
|
- type: github
|
|
|
|
- type: docker
|
|
registry: ghcr.io
|
|
image: org/myapp
|
|
```
|
|
|
|
## Safety
|
|
|
|
All publish commands are **dry-run by default**. Use `--we-are-go-for-launch` to actually publish.
|
|
|
|
```bash
|
|
# Safe preview
|
|
core ci
|
|
|
|
# Actually publish
|
|
core ci --we-are-go-for-launch
|
|
``` |