Linear is a project management tool built for software teams. It lets your Lovable app work with issues, projects, teams, cycles, and comments so you can build internal tools and automations that interact directly with your team’s Linear workspace. With Linear, your app can:Documentation Index
Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
Use this file to discover all available pages before exploring further.
- Create and update issues and comments
- Read team, project, and cycle data
- Build dashboards that surface issue status and progress
- Automate triage, reporting, and planning workflows
Common use cases and example apps
| Example app | Example prompt | Description |
|---|---|---|
| Bug reporting form | Build an internal bug reporter that creates a Linear issue when a user submits a report. | Let users file bugs directly into Linear from your app. The app captures the submission and creates a properly formatted Linear issue in the right team queue, with no manual copy-paste required. |
| Sprint dashboard | Build a sprint dashboard that shows open issues by team and status, grouped by cycle. | Give your team a live view of sprint progress without leaving your app. The app reads current cycle data from Linear and displays issues by status, assignee, or priority. |
| Feature request intake | Build a product request intake form. When someone submits a request, create a Linear issue in the triage backlog. | Turn form submissions into structured Linear issues automatically. The app routes incoming requests directly into your Linear backlog so nothing falls through the cracks. |
| Issue triage workspace | Build an internal triage workspace that shows new Linear issues, lets me filter by team and priority, and update status from one view. | Help teams review and manage incoming work more efficiently. The app reads issues from Linear, organizes them into a focused triage interface, and lets users update priorities or statuses without switching tools. |
| Project health dashboard | Build a project health dashboard that pulls issue counts, completion rates, and blockers from Linear. | Combine Linear data with your app’s context in a single internal view. The app reads project and cycle metrics from Linear and surfaces them alongside other operational data. |
How Linear connections work
Each Linear connection is authorized for a single Linear workspace. When you connect Linear, you authorize Lovable to access Linear on behalf of the authenticated account. Within your Lovable workspace:- You can create multiple Linear connections.
- Each connection is a separate OAuth authorization.
- Each connection can:
- Use different scopes
- Connect to a different Linear workspace
- Multiple projects within a single workspace can use the same connection.
How to connect Linear
Workspace admins and owners can connect Linear. When a connection is created, Linear becomes available across all projects in the workspace.Prerequisites
Before connecting Linear, make sure you have:- A Linear account you can authorize via OAuth
- Lovable workspace admin or owner role
Set up your Linear connection
Configure scopes (optional)
Expand Advanced settings to review or adjust the requested OAuth scopes - the Linear permissions your app needs. Read and Write are selected by default and cover the most common use cases.
Connect to Linear and authorize the connection
- Click Connect. The Linear authorization window opens, so make sure your browser does not block pop-ups.
- Select the workspace you want to connect, review the requested permissions, and click Allow. You’ll be redirected back to Lovable with a confirmation.
Limitations
The Linear connector does not support:- Receiving incoming Linear webhooks or real-time event subscriptions.
- Per-user Linear login where each end user connects their own Linear account
How to unlink projects from a connection
Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:
When unlinked, those projects will no longer have access to through this connection. If a project needs again, you can link it to any available connection.