Skip to content
SynqonixPublic

About

Open-source, self-hostable project management and team chat for small teams, with a VS Code extension. Free-tier friendly.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Synqonix

Project management built for developers.
Plan sprints, track tasks, chat with your team, and start work from your editor.

CI License: FSL-1.1-ALv2 PRs welcome

Why Synqonix

Most project tools live in a browser tab, away from the code. Synqonix keeps tasks, sprints and team chat in one place and brings them into VS Code: pick a task, press Start task, and you are on a correctly named git branch with the task assigned to you and moved to In Progress.

It is self-hostable, runs on a small free-tier stack for a single team, and its source is available under the Functional Source License (FSL-1.1-ALv2).

Features

  • Tasks — epics, stories, tasks, bugs and sub-tasks with keys like SYN-123; markdown descriptions, acceptance criteria, checklists, labels, custom fields, attachments, comments with @mentions, time tracking, task templates and recurring tasks.
  • Views — list, Kanban board (drag and drop), calendar and timeline; saved views and filters.
  • Agile — backlog planning, sprints with burndown and velocity, estimates, releases, milestones and roadmap.
  • Chat — channels, threads, reactions, direct messages and file sharing, live over WebSockets, with task links inside messages.
  • GitHub — branches, commits, pull requests and CI status shown on tasks; merging can move the task; issue sync.
  • Notifications and search — in-app inbox, email digests, muting; one search across tasks, comments, messages and people (only what you may see).
  • Reports and automation — workspace and project reports, CSV/Jira/GitHub import and CSV export, outbound webhooks (HMAC-signed), automation rules, audit log.
  • Teams and permissions — workspaces, teams, roles (Owner, Admin, Member, Viewer), private projects, personal API tokens.
  • VS Code extension (separate repository, synqonix-vscode-extension) — task trees (mine, sprint, backlog, recent), task page, Start task with branch creation, status bar timer, commit-message prefill, notifications.
More screenshots
Task Dark mode

Try it with Docker (one command)

You only need Docker:

git clone https://github.com/abdullahqasim01/synqonix.git
cd synqonix
docker compose up --build

Then open http://localhost:3000, create an account, and open the verification email in the local mailbox at http://localhost:6245; the link signs you in. To start with a sample workspace, run docker compose --profile demo up --build and sign in as demo@synqonix.local / demo-password-123.

This starts Postgres, the API, the web app and Dev-Remail (a local Resend-compatible mailbox, so no real email is sent), applies the database migrations automatically, and keeps your data in Docker volumes (docker compose down -v wipes it). It uses fixed development secrets over plain HTTP, so it is for trying Synqonix and for local use; for a real deployment see Deploying.

Quick start (development)

To work on the code you run the apps yourself with hot reload. You need Node.js 22, npm, and Docker (for Postgres and a local mail inbox only).

git clone https://github.com/abdullahqasim01/synqonix.git
cd synqonix
docker compose -f docker-compose.dev.yml up -d   # Postgres 17.9 on :5432, Dev-Remail mailbox on :6245

# API  → http://localhost:4000  (Swagger UI at /docs)
cd api
cp .env.example .env
npm ci
npx prisma migrate deploy
npm run start:dev

# Web  → http://localhost:3000   (in a second terminal)
cd web
cp .env.example .env.local
npm ci
npm run dev

Optional demo data (a workspace, a Scrum project and an active sprint):

node api/scripts/seed-demo.mjs       # then sign in as demo@synqonix.local / demo-password-123

Emails (verification, password reset, notifications) are sent with the Resend SDK to Dev-Remail; read them at http://localhost:6245.

The VS Code extension

The extension now lives in its own repository: synqonix-vscode-extension. It talks to this API over HTTP, signing in with the browser or a personal API token.

Repository layout

Two independent apps, each with its own package.json and lockfile (no root package, no workspaces):

Folder What it is Stack
api/ REST + WebSocket API NestJS, Prisma, PostgreSQL, Socket.IO, JWT, Resend, S3-compatible storage
web/ Web app Next.js (App Router), Tailwind, typed API client

The API publishes an OpenAPI document (api/openapi.json); web generates its typed client from it (npm run generate:api). Nothing is imported across app folders.

Deploying

  • Anywhere with Docker: docker-compose.prod.yml (production settings and secrets) runs Postgres, the API and the web app. See docs/deployment.md for configuration, upgrades, backups and observability.
  • Free tier for one team: Vercel + Northflank + Neon + Resend + Filebase — step by step in docs/deploy-free-tier.md.
  • Files go to local disk in development or any S3-compatible bucket in production; uploads and downloads always use short-lived presigned links, so the bucket can stay private.

Documentation

User guide First steps and daily use
Deployment Docker, environment reference, upgrades, backups
Free-tier deployment Vercel, Northflank, Neon, Resend, Filebase
GitHub integration Creating and configuring the GitHub App
Test plan Running every automated suite and the manual checklist

Quality

  • API: unit tests plus an end-to-end suite against a real Postgres (permissions matrix over every route, realtime, GitHub webhooks, storage, and more).
  • Web: unit tests and Playwright browser tests (critical flows, CSP, accessibility scan with axe).
  • Security: nonce-based Content-Security-Policy, rate limits, signed webhooks, SSRF-safe outbound webhooks, secret checks at boot, dependency audit and secret scanning in CI. See SECURITY.md.

Roadmap and known gaps

Synqonix is young. Things that are not done yet and good places to help:

  • Live import of issues from the GitHub API (today: through the webhook or CSV), user-defined project templates.
  • Per-workspace retention settings; more automation triggers (assignment, due dates, GitHub events); configurable dashboards.
  • Planning poker.
  • Publishing the VS Code extension (now in its own repository) to the Marketplace and Open VSX.

Contributing

Contributions are welcome — bug reports, ideas and pull requests. Read CONTRIBUTING.md first, and please follow the Code of Conduct. Report security problems privately as described in SECURITY.md.

License

Functional Source License, Version 1.1, ALv2 Future License (FSL-1.1-ALv2): free to use, modify and self-host for any purpose other than a competing use — you may not offer it to others as a commercial product or service that substitutes for Synqonix. Each version becomes available under the Apache License 2.0 two years after its release. It is Fair Source, not open source. The Synqonix name and logo are not covered by the license grant (see NOTICE).

About

Open-source, self-hostable project management and team chat for small teams, with a VS Code extension. Free-tier friendly.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages