Skip to content

docs: Update README for standalone package - #13

Merged
frankieyan merged 2 commits into
mainfrom
frankie/update-readme
Jan 16, 2026
Merged

frankieyan merged 2 commits into
mainfrom
frankie/update-readme

Conversation

@frankieyan

Copy link
Copy Markdown
Member

Summary

  • Expanded README with comprehensive documentation for standalone npm package usage
  • Added Prerequisites, Installation, Usage sections with all CLI modes
  • Added Integration Examples for Husky, lint-staged, and GitHub Actions CI

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@frankieyan frankieyan self-assigned this Jan 16, 2026
@frankieyan
frankieyan requested review from a team and rfgamaral and removed request for a team January 16, 2026 00:20
@frankieyan frankieyan added the 👀 Show PR PR must be reviewed before or after merging label Jan 16, 2026

@doistbot-app doistbot-app Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The README changes effectively document the new standalone package capabilities and integration options. However, the GitHub Actions example requires a specific checkout configuration to work correctly, and the lint-staged example has a potential side effect regarding record maintenance that should be noted.

Comment thread README.md Outdated
```json
{
"lint-staged": {
"src/**/*.{js,jsx,ts,tsx}": "npx @doist/react-compiler-tracker --check-files"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Using --check-files with lint-staged ensures no new violations are introduced, but it does not update the .react-compiler-tracker.json file when violations are fixed. This leads to the tracker file becoming stale (expecting errors that no longer exist). It would be helpful to note this limitation or the potential need for manual updates, contrasting it with the Husky workflow which handles updates automatically.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch

Comment thread README.md
- name: Check React Compiler violations
run: |
# Get changed files in the PR
FILES=$(git diff --name-only origin/main...HEAD -- '*.tsx' '*.ts' '*.jsx' '*.js' | tr '\n' ' ')

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The command git diff ... origin/main...HEAD relies on origin/main being available, but the default actions/checkout configuration performs a shallow fetch and does not include remote branches. To prevent CI failures, consider adding a comment noting that fetch-depth: 0 is required in the actions/checkout step.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just a general example that the user will need to adapt to their needs, so I don't think it needs to consider edge cases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@frankieyan
frankieyan merged commit 563b412 into main Jan 16, 2026
2 checks passed
@frankieyan
frankieyan deleted the frankie/update-readme branch January 16, 2026 00:46

@rfgamaral rfgamaral left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

👀 Show PR PR must be reviewed before or after merging

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants