GitHub (AIK)

This template uses Github Actions and ships with Astro Integration Kit. Copy it locally by running the following command:

pnpm dlx giget@latest gh:florian-lefebvre/astro-integration-template/templates/github-kit my-integration

Prerequisites

Make sure you have a GitHub and NPM account.

Setup

1. Search for TODO: and update them.

2. Update all occurrences of package-name with your package name.

3. Update .changeset/config.json with your organization’s repository name (org/repo-name).

4. Add a LICENSE at the root (if you do it through GitHub interface, you’ll be able to see all licenses and pick the best one for your project).

5. Pick the right NPM tags, see official docs.

6. Setup your GitHub repository.

7. Follow the the e18e publishing guide. The release workflow is properly configured for OIDC publishing and is called release.yml

Good practises

• Start working on your integration logic.
• Write some docs, either in the README or as a standalone docs website (not included in the template).
• Write good JSDoc annotations.
• Format and lint with pnpm lint:fix.

Releasing

This template uses the GitHub Action for Changesets to automatically open a Pull Request to release a package. Once this Pull Request is merged, the package will be published to NPM.

1. Add a changeset and add a meaningful message:

   pnpm changeset

   You can write several changesets if applicable.

2. Commit and push:

   git add .
   git commit -m "chore: changeset"
   git push

3. The Changesets GitHub Action will automatically create a Pull Request for the release.

4. Review and merge the release Pull Request. Ensure you’re ready to publish the changes before merging.

5. The package will be published to NPM automatically throuh OIDC.