Minimal public customer portal that integrates directly into Linear (no db in between)
This project uses experimental
Remote Functionsfrom Svelte and uses encrypted file to store tokens. (not the most optimal solution, but the simplest I could have come up with)
With Node.js 22.12+ and Bun 1.3.14 installed:
bun install --frozen-lockfile
bun run setup
bun run devVisit http://localhost:5173 for your customer portal. Follow the setup and deployment guide to configure Linear, customer sign-in, and persistent hosting. Docker Compose is included.
Linear is amazing with what it does, but I do not want to pay more money to get a simple upvoting system.
Needline makes it super easy to get customer needs and allow other customers to upvote. It brings that feedback directly into linear.
Any Linear issue or project tagged with needline is shown in the portal.
Customers can submit a request with:
- what they need
- why they need it
- urgency
Needline calculates a needLevel from the number and urgency of requests, then displays it next to each item.
Authenticated users can submit requests on behalf of their customer company.
Linear remains the source of truth:
- tagged issues/projects are shown publicly
- customer requests are attached back to Linear
- request volume and urgency determine the visible need level
- The root app (
src/) is the self-hosted customer portal. Its Dockerfile and Compose deployment ship only the portal. site/is the independently installed and deployed static marketing website. Self-hosters do not need it.- Architecture explains the separation and dependency rules.