You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+48-3Lines changed: 48 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -122,29 +122,74 @@ The action automatically creates the following labels:
122
122
123
123
```bash
124
124
npm install
125
+
npm run build
125
126
```
126
127
128
+
### Building
129
+
130
+
The action uses [@vercel/ncc](https://github.com/vercel/ncc) to compile the code and dependencies into a single file. This eliminates the need to commit `node_modules`.
131
+
132
+
```bash
133
+
npm run build
134
+
```
135
+
136
+
This creates a `dist/index.js` file that includes all dependencies bundled together.
137
+
127
138
### File Structure
128
139
129
140
```
130
141
github-custom-action-examples/
131
-
├── action.yml # Action metadata
132
-
├── index.js # Main logic
142
+
├── action.yml # Action metadata (points to dist/index.js)
143
+
├── index.js # Main logic (source)
144
+
├── dist/
145
+
│ └── index.js # Bundled code with dependencies (commit this!)
133
146
├── package.json # Dependencies
134
147
├── README.md # Documentation
135
148
└── .github/
136
149
└── workflows/
150
+
├── release.yml # Semantic Release workflow
137
151
├── pr-size-check.yml # Local usage example
138
152
└── pr-size-check-external.yml # External usage example
139
153
```
140
154
155
+
## Releases and Versioning
156
+
157
+
This project uses [Semantic Release](https://semantic-release.gitbook.io/) for automated versioning and releases.
158
+
159
+
### Commit Message Format
160
+
161
+
Follow the [Conventional Commits](https://www.conventionalcommits.org/) specification:
162
+
163
+
- `feat:` - A new feature (triggers minor version bump)
164
+
- `fix:` - A bug fix (triggers patch version bump)
165
+
- `docs:` - Documentation changes
166
+
- `chore:` - Maintenance tasks
167
+
- `BREAKING CHANGE:` - Breaking changes (triggers major version bump)
168
+
169
+
**Examples:**
170
+
171
+
```bash
172
+
feat: add support for custom label colors
173
+
fix: resolve issue with label removal
174
+
docs: update README with new examples
175
+
chore: update dependencies
176
+
```
177
+
178
+
### How It Works
179
+
180
+
1. Push commits to `main` branch using conventional commit format
181
+
2. Semantic Release analyzes commits and determines version bump
182
+
3. Automatically generates CHANGELOG.md
183
+
4. Creates a GitHub release with release notes
184
+
5. Updates version in package.json
185
+
141
186
## Contributing
142
187
143
188
Contributions are welcome! Please:
144
189
145
190
1. Fork the repository
146
191
2. Create a branch for your feature
147
-
3. Commit your changes
192
+
3. Commit your changes using conventional commit format
0 commit comments