Skip to content

springtype-org/github-action-npm-publish

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

github-action-npm-publish

This GitHub Action automates the process of publishing npm packages. It simplifies the workflow for JavaScript and TypeScript projects by integrating seamlessly with your CI/CD pipeline. With this action, you can automatically publish your npm package whenever changes are pushed to your repository, ensuring that your package is always up-to-date with the latest commits.

User Stories

  1. As a developer, I want to automate the npm publishing process to save time and reduce manual errors.
  2. As a developer, I want to ensure that my npm package is published whenever changes are pushed to the main branch.

Features

  • ✅ Automates npm package publishing
  • ✅ Integrates seamlessly with GitHub Actions workflows
  • ✅ Supports scoped packages
  • ✅ Configurable to run on specific branches or tags
  • ✅ Securely handles npm authentication
  • ✅ Provides detailed logs for troubleshooting
  • ✅ Supports both JavaScript and TypeScript projects
  • ✅ Easily configurable via npmrc settings

Example Usage

Setup

  1. Create a GitHub Workflow File: Add a new YAML file in .github/workflows/ (e.g., publish.yml):

    name: Publish to npm
    
    on:
      push:
        branches:
          - main
    
    jobs:
      publish:
        runs-on: ubuntu-latest
    
        steps:
          - name: Checkout code
            uses: actions/checkout@v2
    
          - name: Setup Node.js
            uses: actions/setup-node@v2
            with:
              node-version: '14'
    
          - name: Install dependencies
            run: npm install
    
          - name: Publish to npm
            uses: your-username/github-action-npm-publish@v1
            with:
              authToken: ${{ secrets.NPM_AUTH_TOKEN }}
              registry: 'https://registry.npmjs.org/'
  2. Set Up npm Authentication: Store your npm authentication token as a secret in your GitHub repository settings. Go to Settings > Secrets and add a new secret named NPM_AUTH_TOKEN with your npm token.

Using the Action

  • Publishing: The action will automatically publish your package to npm whenever you push changes to the main branch (or any other branch you configure).
- name: Publish to npm
  uses: your-username/github-action-npm-publish@v1
  with:
    authToken: ${{ secrets.NPM_AUTH_TOKEN }}
    registry: 'https://registry.npmjs.org/'

Configuration

  • authToken: The npm authentication token. Store it securely in GitHub secrets.
  • registry: The npm registry URL (default: https://registry.npmjs.org/).

Troubleshooting

  • Ensure that the NPM_AUTH_TOKEN secret is correctly set in your GitHub repository.
  • Verify that the workflow file is correctly configured and located in the .github/workflows/ directory.
  • Check the action logs in the GitHub Actions tab for detailed error messages and troubleshooting steps.

Support

For any issues or feature requests, please open an issue on the GitHub repository.


This action simplifies and automates the npm publishing process, ensuring that your packages are always up-to-date with minimal manual intervention.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published