https://github.com/linear/linear
Tools, SDK's and plugins for Linear
https://github.com/linear/linear
Last synced: 22 days ago
JSON representation
Tools, SDK's and plugins for Linear
- Host: GitHub
- URL: https://github.com/linear/linear
- Owner: linear
- License: mit
- Created: 2019-04-11T22:54:14.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-03T00:18:46.000Z (10 months ago)
- Last Synced: 2025-05-03T01:35:58.008Z (10 months ago)
- Language: TypeScript
- Size: 11.4 MB
- Stars: 902
- Watchers: 23
- Forks: 163
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - linear
README
Linear API
The purpose-built tool for planning and building products
Streamline issues, projects, and product roadmaps
with the system for modern software development.
## ⚠️ Monorepo Readme
If you are looking for documentation on the Linear SDK or Linear API, visit [**developers.linear.app**](https://developers.linear.app/docs) instead.
The Linear Client uses custom [GraphQL Code Generator](https://graphql-code-generator.com/) plugins to produce a typed SDK for all operations and models exposed by the Linear production API.
### Structure
This monorepo uses `pnpm` workspaces to manage and publish packages.
Generated code uses file prefix `_generated` and should never be manually updated.
Open source packages:
- [sdk](https://github.com/linear/linear/tree/master/packages/sdk/README.md) - The Linear Client SDK for interacting with the Linear GraphQL API
- [import](https://github.com/linear/linear/tree/master/packages/import/README.md) - Import tooling for uploading from other systems
- [codegen-doc](https://github.com/linear/linear/tree/master/packages/codegen-doc/README.md) - GraphQL codegen plugin to generate GraphQL fragments and documents
- [codegen-sdk](https://github.com/linear/linear/tree/master/packages/codegen-sdk/README.md) - GraphQL codegen plugin to generate Typescript SDK from fragments and documents
- [codegen-test](https://github.com/linear/linear/tree/master/packages/codegen-test/README.md) - GraphQL codegen plugin to generate a jest test for the Typescript SDK
### Get Started
Make sure you have Node 18+ and Corepack enabled (`corepack enable`).
```shell
# install dependencies
pnpm install
# build all packages
pnpm build
# test all packages
pnpm test
# update the schema from the production API
pnpm schema
# create changeset for generating CHANGELOG.md
pnpm changeset
```
### Plugin Flow
1. The [@linear/codegen-doc](https://github.com/linear/linear/tree/master/packages/codegen-doc/README.md) plugin is used by [codegen.doc.yml](https://github.com/linear/linear/tree/master/packages/sdk/codegen.doc.yml) to generate [fragments and documents](https://github.com/linear/linear/tree/master/packages/sdk/src/_generated_documents.graphql)
2. The [@linear/codegen-sdk](https://github.com/linear/linear/tree/master/packages/codegen-sdk/README.md) plugin is used by [codegen.sdk.yml](https://github.com/linear/linear/tree/master/packages/sdk/codegen.sdk.yml) to generate the typed [Linear SDK](https://github.com/linear/linear/tree/master/packages/sdk/src/_generated_sdk.ts)
3. The [@linear/codegen-test](https://github.com/linear/linear/tree/master/packages/codegen-test/README.md) plugin is used by [codegen.test.yml](https://github.com/linear/linear/tree/master/packages/sdk/codegen.test.yml) to generate a typed [jest test](https://github.com/linear/linear/tree/master/packages/sdk/src/_tests/_generated.test.ts)
## License
Licensed under the [MIT License](./LICENSE).