TaskNebula architecture

A conventional stack
with agent-aware edges.

TaskNebula's technical story is strongest when it is precise: Next.js 15, PostgreSQL 16 with pgvector, Redis 7, SSE realtime, optional LiveKit, Docker Compose, next-intl localization, and public roadmap discipline.

AI off by default
30-language app shell
Docker Compose install
AGENTOWNERS governance
TaskNebula workspace home screen with dashboard and project management modules

Real product screenshot

Self-hosted project management, AI drafting, governance, and update awareness in one workspace.

Latest release

Locales

GitHub stars

License

Stack map

This is intentionally not a novelty stack. The repo's value proposition is a self-hosted PM control plane with AI-agent governance on top of infrastructure teams already know.

Frontend

Next.js 15 App RouterReact 19TypeScript 5.7Tailwindshadcn/uiTanStack Query

Backend

Next.js route handlersAuth.js v5Drizzle ORMZod contractsPino logging

Data

PostgreSQL 16pgvectorRedis 7S3-compatible uploadspg_stat_statements

Realtime

SSE event busRedis pub/subYjs editingLiveKit voice rooms

Ops

Docker ComposePublished imageCron sidecarHealth checksReverse proxy ready

Trust

AES-256-GCM credentialsSigned webhooksAudit logsAGENTOWNERSApproval gates

System model

The public roadmap explicitly says what not to build: not a chat/video/wiki super-app, not a full standalone calendar, not native mobile first. The core is the work graph.

01

TaskNebula ships as a standalone Next.js 15 web container with App Router, React 19, route handlers, and Docker-first runtime assumptions.

Next.js 15React 19Docker

02

The roadmap explicitly positions TaskNebula as a self-hostable Linear control plane that avoids sprawling infrastructure and centers the work graph around PostgreSQL.

PostgreSQL 16pgvectorDrizzle

03

Issue create/update/delete events use SSE with Redis pub/sub and in-process fallback for single-instance installs. Yjs supports collaborative editing where wired.

SSERedis pub/subYjs

04

The app ships 30 languages, browser/device auto-detection, native-name language switching, and RTL support for Arabic and Hebrew.

next-intl30 localesRTL

05

RBAC, issue security levels, audit-log action types, signed webhooks, AGENTOWNERS, and approval gates are part of the public technical story.

RBACHMACAudit

06

The roadmap names shipped, partial, and open work, including tenant isolation, API-key auth, pagination, MCP v2, importer v2, and governance completion.

Q3 2026Q4 2026H1 2027

Runtime data flow

Operating flow
1

Browser / PWA

localized app

2

Next.js route handlers

Zod + auth

3

PostgreSQL work graph

issues + embeddings

4

Redis fan-out

SSE events

5

AI / integrations / agents

opt-in BYOK

Architecture summary is grounded in the public README, docker-compose.yml, and ROADMAP_2026.md.

Roadmap posture

That is useful for technical buyers: it prevents overclaiming and turns the page into an honest evaluation surface instead of a glossy project landing page.

Q3 2026

Labels, components, versions, resolution, issue rank, workflow enforcement, boards, JQL v2, notification schemes, tenant isolation, API keys, pagination, and scale floor.

Q4 2026

Deep GitHub/GitLab links, importer v2, release notes, semantic search, Ask-AI last mile, agent approval queue, MCP v2, and coding-agent deeplinks.

H1 2027

Custom hierarchy, field schemes, permission enforcement, portfolio plans, SLAs, configurable dashboards, proactive risk detection, and agent builder direction.

Evaluation notes

TaskNebula should not claim finished enterprise parity everywhere. The repo itself documents gaps and staged work, which makes the public page more credible.

Built but still being wired

Ask/RAG, embeddings, MCP, agent engine, analytics, and importer work have visible roadmap follow-through.

Trust hardening track

Tenant isolation, API-key scopes, pagination, type-safety restoration, and governance completion are named as platform prerequisites.

Product direction

Self-hostable Linear, control plane for AI agents, Postgres-first operations, and no super-app sprawl.

Run it yourself

TaskNebula is positioned as the self-hostable project-management control plane for teams that want inspectable operations, not another black-box SaaS.