3d6e683f5e
<!-- This is an auto-generated description by cubic. --> ## Summary by cubic Adds an explicit Husky pre-commit setup to run the formatter and linter before each commit. Replaces the auto-run prepare hook with a manual npm run init-precommit command. - **Migration** - Run npm run init-precommit once in your repo to install the pre-commit hook. <!-- End of auto-generated description by cubic. -->
81 lines
1.8 KiB
Markdown
81 lines
1.8 KiB
Markdown
# Contributing
|
|
|
|
Dyad is still a very early-stage project, thus the codebase is rapidly changing.
|
|
|
|
Before opening a pull request, please open an issue and discuss whether the change makes sense in Dyad. Ensuring a cohesive user experience sometimes means we can't include every possible feature or we need to consider the long-term design of how we want to support a feature area.
|
|
|
|
For a high-level overview of how Dyad works, please see the [Architecture Guide](./docs/architecture.md). Understanding the architecture will help ensure your contributions align with the overall design of the project.
|
|
|
|
## More than code contributions
|
|
|
|
Something that I really appreciate are all the non-code contributions, such as reporting bugs, writing feature requests and participating on [Dyad's sub-reddit](https://www.reddit.com/r/dyadbuilders).
|
|
|
|
## Development
|
|
|
|
Dyad is an Electron app.
|
|
|
|
**Install dependencies:**
|
|
|
|
```sh
|
|
npm install
|
|
```
|
|
|
|
**Apply migrations:**
|
|
|
|
```sh
|
|
npm run db:generate
|
|
npm run db:push
|
|
```
|
|
|
|
**Run locally:**
|
|
|
|
```sh
|
|
npm start
|
|
```
|
|
|
|
## Setup
|
|
|
|
If you'd like to contribute a pull request, we highly recommend setting the pre-commit hooks which will run the formatter and linter before each git commit. This is a great way of catching issues early on without waiting to run the GitHub Actions for your pull requet.
|
|
|
|
Simply run this once in your repo:
|
|
|
|
```sh
|
|
npm run init-precommit
|
|
```
|
|
|
|
## Testing
|
|
|
|
### Unit tests
|
|
|
|
```sh
|
|
npm test
|
|
```
|
|
|
|
### E2E tests
|
|
|
|
Build the app for E2E testing:
|
|
|
|
```sh
|
|
npm run pre:e2e
|
|
```
|
|
|
|
> Note: you only need to re-build the app when changing the app code. You don't need to re-build the app if you're just updating the tests.
|
|
|
|
Run the whole e2e test suite:
|
|
|
|
```sh
|
|
npm run e2e
|
|
```
|
|
|
|
Run a specific test file:
|
|
|
|
```sh
|
|
npm run e2e e2e-tests/context_manage.spec.ts
|
|
```
|
|
|
|
Update snapshots for a test:
|
|
|
|
```sh
|
|
npm run e2e e2e-tests/context_manage.spec.ts -- --update-snapshots
|
|
```
|