create-action-llama

Scaffold a new Action Llama project.

Usage

npx create-action-llama my-app

Development

Prerequisites

• Node.js >= 18
• npm

Install dependencies

npm install

Versioning & Publishing

This project uses Changesets for version management and npm publishing.

Adding a changeset

When you make a change that should be released, create a changeset:

npx changeset

You'll be prompted to:

1. Select the package (this one)
2. Choose the semver bump type (patch, minor, or major)
3. Write a summary of the change

This creates a markdown file in .changeset/ describing the change. Commit it with your PR.

Releasing a new version

When you're ready to release:

# 1. Consume all pending changesets and bump the version in package.json
npx changeset version

# 2. Review the updated package.json version and CHANGELOG.md
git add -A && git commit -m "chore: release"

# 3. Publish to npm
npm publish --access public

# 4. Push the release commit and tag
git push && git push --tags

CI Publishing (GitHub Actions)

For automated releases, add the Changesets GitHub Action to your workflow:

# .github/workflows/release.yml
name: Release

on:
  push:
    branches: [main]

permissions:
  contents: write
  pull-requests: write

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          registry-url: "https://registry.npmjs.org"
      - run: npm install
      - uses: changesets/action@v1
        with:
          publish: npm run release
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

Set NPM_TOKEN in your repository secrets (Settings > Secrets > Actions) with an npm access token that has publish permissions.

License

MIT