nodejs-actions-starter-template

👋 Starter template with the action layout, linting, CI, and publishing pre-configured

A complete GitHub Action starter template that includes:

• ✅ Action boilerplate with inputs/outputs
• ✅ ESLint configuration for code quality
• ✅ Jest testing framework with sample tests
• ✅ GitHub Actions CI/CD workflow
• ✅ Automated bundling with ncc
• ✅ Example implementation that works out of the box
• ✅ GitHub REST API integration with Octokit
• ✅ Repository statistics fetching example

Getting Started

1. Use This Template

1. Click "Use this template" to create a new repository
2. Clone your new repository locally
3. Run npm install to install dependencies

2. Customize Your Action

📋 See TEMPLATE_CHECKLIST_DELETE_ME.md for a comprehensive customization guide

1. Update package.json with your action name and details
2. Update action.yml with your action's inputs and outputs
3. Modify src/index.js with your action logic
4. Update this README with your action's documentation
5. Update the publish workflow if needed

3. Test Your Action

npm test              # Run tests
npm run lint          # Check code quality with ESLint
npm run format:write  # Run Prettier for formatting
npm run coverage      # Generate coverage badge
npm run package       # Bundle for distribution
npm run all           # Alternatively: Run format, lint, test, coverage, and package

Example Usage

- name: Hello World Action
  uses: your-username/your-action-name@v1
  with:
    who-to-greet: 'World'
    include-time: true
    message-prefix: 'Hello'
    github-token: ${{ secrets.GITHUB_TOKEN }} # Optional: for repo stats

Action Inputs

Input	Description	Required	Default
who-to-greet	Who to greet in the message	No	'World'
include-time	Whether to include current time in output	No	false
message-prefix	Prefix for the greeting message	No	'Hello'
github-token	GitHub token for API access (enables repo stats)	No	-

Action Outputs

Output	Description
message	The generated greeting
time	Current timestamp (if requested)
repo-stats	Repository statistics JSON (if token provided)

Development

This template includes everything you need to start developing GitHub Actions:

Development Setup

1. Clone this repository
2. Install dependencies: npm install
3. Make your changes to src/index.js
4. Run tests: npm test
5. Build the action: npm run package

Available Scripts

• npm test - Run Jest tests
• npm run lint - Run ESLint
• npm run format:write - Format code with Prettier
• npm run package - Bundle the action with ncc
• npm run all - Run format, lint, test, coverage, and package

Testing Locally

You can test the action locally by setting environment variables:

export INPUT_WHO_TO_GREET="Local Dev"
export INPUT_INCLUDE_TIME="true"
export INPUT_MESSAGE_PREFIX="Hey"
node src/index.js

Project Structure

├── src/
│   └── index.js          # Main action code
├── __tests__/
│   └── index.test.js     # Jest tests
├── dist/                 # Bundled action (generated)
├── action.yml           # Action metadata
├── package.json         # Dependencies and scripts
└── README.md           # This file