Skip to content

Commit bd6b66f

Browse files
committed
update release process
1 parent 55146ab commit bd6b66f

File tree

1 file changed

+50
-0
lines changed

1 file changed

+50
-0
lines changed

CLAUDE.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,56 @@ npm run deploy # Deploy to VS Code marketplace
4444
npm run release # Build and publish to npm (uses changesets)
4545
```
4646

47+
### Version Management with Changesets
48+
49+
This project uses [Changesets](https://github.com/changesets/changesets) for version management. GitHub Actions automatically handle version bumping and releases.
50+
51+
**IMPORTANT: Never run `changeset version` manually!** GitHub Actions will handle this.
52+
53+
#### Adding a Changeset
54+
55+
When you make changes that require a version bump:
56+
57+
1. **Create a changeset file manually** (non-interactive):
58+
```bash
59+
# Create a file in .changeset/ with a descriptive name
60+
# Example: .changeset/add-nested-variables.md
61+
```
62+
63+
2. **Changeset file format**:
64+
```markdown
65+
---
66+
"css-variables-language-server": minor
67+
"vscode-css-variables": minor
68+
---
69+
70+
Description of your changes.
71+
72+
- Feature 1
73+
- Feature 2
74+
75+
Example code if needed.
76+
```
77+
78+
3. **Commit only the changeset file**:
79+
```bash
80+
git add .changeset/your-changeset.md
81+
git commit -m "add changeset for feature X"
82+
git push
83+
```
84+
85+
4. **GitHub Actions will automatically**:
86+
- Detect the changeset
87+
- Create a "Version Packages" PR
88+
- Bump versions in package.json
89+
- Update CHANGELOG.md files
90+
- When the PR is merged, publish to npm and VS Code marketplace
91+
92+
**Version bump types**:
93+
- `patch`: Bug fixes (2.7.2 → 2.7.3)
94+
- `minor`: New features (2.7.2 → 2.8.0)
95+
- `major`: Breaking changes (2.7.2 → 3.0.0)
96+
4797
## Architecture
4898

4999
### Language Server Pattern

0 commit comments

Comments
 (0)