navree

Ecosystem

Everything first‑party.Everything included.

Monitoring, deployment, an admin panel, queue supervision, search, billing, OAuth, AI and more are part of Navree. They are open source, they run on your servers, and they are designed, documented and released with the framework.

Get startedRead the docs
Manifestnavree 0.1 · MIT OR Apache-2.0
Some of what comes with Navree, where it lives in your app, and whether it is included
Package or toolWhat it isWhere it livesIncluded
Lighthouse/_lighthouseIncluded
Fleet/_fleetIncluded
Harbornavree deployIncluded
Helm/adminIncluded
Logbook/_logbookIncluded
Navigatornavree mcpIncluded
Workspacesnavree-workspaceIncluded
Searchnavree-searchIncluded
Billingnavree-billingIncluded
OAuth servernavree-oauthIncluded
AI SDKnavree-aiIncluded
Microservicesnavree-microIncluded
and 21 more, below
paid add-ons 0accounts 0
33first-party packages and tools
Documented here, built to the framework's conventions.
$0paid add-ons
No tiers, no seats, no hosted plan. MIT OR Apache-2.0.
1version number
Tested, documented and released together.
100%self-hosted
Dashboards run in your app; the data stays on your servers.

01 Run in production

See what production is doing, and ship to it without downtime.

Monitoring, queue supervision and deployment, built into the framework and hosted by you.

/_lighthouse

Lighthouse

Application monitoring, built in.

Exceptions, slow requests, slow queries, failed jobs and outgoing HTTP, grouped into issues and shown in a dashboard inside your app. Alerts go to email, Slack or a webhook, scripts read and resolve issues through its JSON API, and your coding agent through its MCP tools.

  • Issues grouped by fingerprint
  • Slow request and query traces
  • Alerts to email, Slack and webhooks
  • JSON API and MCP tools for agents
  • Dashboard served by your app
Read the Lighthouse docsnavree::LighthouseModule::from_config()
The Lighthouse dashboard of the example CRM: requests per minute, error rate, p95 latency, failed jobs and open issues; a 24-hour timeline of requests and exceptions; issues such as a slow contacts query on the deal board and a declined card when charging an invoice; and a live feed of new occurrences.
/_fleet

Fleet

Queue dashboard and worker supervisor.

Run supervised workers per queue that balance themselves under load. Watch throughput, wait times and runtimes, and retry or forget failed jobs from one dashboard.

  • Auto-balanced workers
  • Throughput and wait-time metrics
  • Retry or forget failed jobs
  • Pause and continue queues
  • Long-wait alerts
Read the Fleet docsnavree fleet
The Fleet dashboard of the example CRM: two supervisors running queue workers. When a newsletter puts 3,000 mails on the mail queue, Fleet moves processes to it, from one up to six, while the default and notifications queues keep what they need; below, mail jobs per minute spike at 09:00, and a list of failed jobs offers Retry and Forget.
navree deploy

Harbor

Servers and zero-downtime deployments.

Provision a server over SSH with TLS, PostgreSQL, Redis and systemd units for your web, worker and scheduler processes, then ship atomic releases that only go live after a health check.

  • Provision any Ubuntu server
  • Atomic, health-checked releases
  • One-command rollbacks
  • Encrypted environment secrets
  • Container images and push-to-deploy
Read the Harbor docsnavree deploy
Harbor deploying the example CRM with navree deploy: it builds, uploads, migrates, starts the new release in the green slot, waits for GET /health/ready to answer 200, switches Caddy from blue to green, drains blue and restarts the workers. Beside the terminal, the server app-1 shows its blue and green slots and the releases kept for rollbacks.

02 Build faster

Start with a product, not an empty directory.

Starter kits, an admin panel, a local debugger and local services, ready on day one.

/admin

Helm

An admin panel generated from your entities.

Describe a resource once and get list, detail and edit screens with filters, bulk actions and metrics. Every screen respects the access rules your API already enforces.

  • Resources from entities
  • Filters, actions and metrics
  • Uses your access policies
  • Custom fields and pages
Read the Helm docsnavree make:resource deals Deal
Helm, the admin panel of the example CRM, on the Deals resource: a sidebar with the CRM's resources, metric cards for the open pipeline, new deals and deals by stage; search and filters for stage and owner; a table of deals with amount, stage, company, owner and expected close date. Three deals are ticked and the bulk action Mark as won runs on them after a confirmation.
/_logbook

Logbook

A local debugging timeline.

Every request in development with the queries it ran, the events it fired, the jobs it queued, the mail it sent and the log lines it wrote, in one timeline you can filter and replay.

  • Requests, queries, jobs, mail and events
  • Filter by tag or user
  • Replay a request
  • Development only
Read the Logbook docsnavree::LogbookModule::from_config()
Logbook in development, open on the request POST /api/v1/deals: a list of recent requests and jobs on the left, one marked for duplicate queries; on the right the request's summary and its timeline, with the access check, each query, the deal.created event, the queued job and mail, the cache call, a log line and the 201 response, drawn against its 24 milliseconds.

Starter kits

The SaaS kit gives you a Next.js and shadcn/ui front end with sign-in, workspaces, billing, settings and an admin panel, wired to a Navree API. API and microservice kits start leaner.

navree new acme --kit saas
Starter kits docs

Dock

Start PostgreSQL, Redis, Meilisearch, Mailpit, MinIO and NATS in containers, with your app's environment already pointing at them.

navree dock up
Dock docs

03 Product capabilities

Search, billing, sign‑in and flags, ready when you need them.

The features every product grows into, designed to work with workspaces, access control and the queue.

Workspaces

Workspaces, members, roles and invitations, with every query scoped to the current workspace. Isolate data by row, by schema or by database, and seed demo workspaces from fixtures. On by default.

async fn index(ws: CurrentWorkspace, uow: Uow)
Workspaces docs

Search

Derive Searchable on an entity and its index stays in sync through the queue. Query PostgreSQL full text, Meilisearch, Typesense or an embedded Tantivy index, and store vectors in pgvector or Qdrant.

search.query::<Contact>("ada").paginate(page)
Search docs

Billing

Make a user or a workspace billable, then handle plans, trials, metered usage, invoices and the customer portal. Payment webhooks are verified and processed on the queue.

BillingModule::for_feature::<Workspace>()
Billing docs

Feature flags

Define a flag as a type, check it anywhere, or guard a whole route with it. Flags live in your database and are cached.

flags.active::<NewPipeline>().await?
Feature flags docs

OAuth server

Let third-party apps act on behalf of your users with authorization code and PKCE, client credentials and device flows, scopes, a consent screen and personal access tokens.

navree oauth:client "Zapier" --scopes deals:read
OAuth server docs

Social sign-in

Redirect to a provider, handle the callback and get a Navree user with linked accounts and normal Navree tokens.

self.social.redirect("github").await?
Social sign-in docs

Single sign-on

Connect each customer's identity provider, route sign-in by verified email domain, refuse passwords where single sign-on is enforced and provision members with roles from their groups.

self.sso.login("acme", return_to).await?
Single sign-on docs

Webhooks

Send HMAC-signed webhooks with retries and a delivery log, and verify incoming webhooks from Stripe, GitHub, Paddle and any Standard Webhooks sender.

impl WebhookEvent for DealWon
Webhooks docs

Integrations

Let every workspace or organization connect its own Microsoft 365, Google Workspace, Slack, OAuth 2.0 APIs and API keys. Credentials are encrypted, tokens refresh once under a lock, each feature gets only the scopes it needs, and health checks warn you when a connection stops working.

graph.get("/users").send().await?
Integrations docs

Directory sync

Provision people from Microsoft Entra ID and Okta over SCIM 2.0, or pull them from Microsoft Graph, Google Workspace, Okta, LDAP and Active Directory. One normalized directory, mapped into your model by a sink, in runs with dry runs, a deactivation limit and progress.

impl DirectorySink for RecipientSink
Directory sync docs

Custom domains

Let customers bring crm.acme-corp.com. Navree hands them the DNS records to create, verifies them, gets the certificate through your proxy's on-demand TLS or from Let's Encrypt itself, and resolves each request's workspace from its host.

domains.add(workspace, NewDomain::new("crm.acme-corp.com"))
Custom domains docs

Documents

Render certificates, invoices and reports as PDF from HTML templates or documents built in code, laid out in process or printed by headless Chrome, in any script, and write DOCX. Merge, stamp and queue them.

documents.pdf("certificates/classic", &data).await?
Documents docs

Media

Attach uploads and remote files to your models in collections that check types and sizes. Generate thumbnails, WebP copies and responsive variants on the queue, unpack zip and SCORM packages safely, extract text from PDF and DOCX, and process video with FFmpeg.

media.add(&course, "thumbnail", source).save(&uow).await?
Media docs

Imports and exports

Export typed rows as CSV with a byte-order mark and escaped formulas or as XLSX, streamed or queued to a disk with a signed link. Import files in any encoding with header mapping, row validation, a staging preview, duplicate handling and error files.

Download::csv("contacts", rows)
Imports and exports docs

Workflows

Write long-running sequences as async functions whose steps are stored and replayed on resume, with retries, sleeps of minutes or months and event waits. Let people build their own automations from your triggers, conditions and actions, with versions, enrollments and simulation.

ctx.wait_for::<CourseCompleted>(filter, 7 * DAY).await?
Workflows docs

Localization

Write translations in Fluent files and pick the locale from the user, the workspace or the browser. Validation messages and mail are translated too.

t!("deal-created", count = 3)
Localization docs

04 Connect services

Services and clients, connected by the same modules.

Messages, events, gRPC, GraphQL and real time between your services and your clients.

Microservices

Handle messages with the same modules, providers and guards as your HTTP routes. Pick TCP, NATS, Kafka, RabbitMQ, Redis Streams or MQTT, and run HTTP and messages in one binary.

#[event_pattern("deal.won")]
Microservices docs

gRPC

Register a tonic service in a module and it shares the container, the guards and the access rules of the rest of your app.

#[grpc_service]
gRPC docs

GraphQL

Write resolvers on async-graphql inside your modules, batch with per-request dataloaders and push subscriptions over WebSockets.

#[resolver]
GraphQL docs

Real time

Broadcast events to public, private and presence channels from your own binary. pusher-js and any Pusher client connects.

self.broadcaster.broadcast(channels, event, data)
Real time docs

05 AI

An MCP server for your coding agent, an AI SDK for your product.

For the agents that write your code and the AI features inside your product.

navree mcp

Navigator

The MCP server for your coding agent.

Give Claude Code, Cursor, Codex or any MCP client a live view of your app: routes, the module graph and providers, the database schema, read-only SQL, configuration, recent logs and docs that match your Navree version.

  • Routes and the module graph
  • The database schema and read-only SQL
  • Recent logs and the last error
  • Version-matched docs search
Read the Navigator docsnavree mcp
A coding agent fixing the example CRM with Navigator. Asked why the deals page returns 500, it calls last_error, which shows a missing column deals.expected_close_date; describe_schema, which shows the migration that adds it is pending; and list_commands. It answers: run navree migrate. Beside the session, Navigator's twelve tools, with the three it used marked.

Agent skills

Skills for modules, routes, validation, the database, auth, workspaces, queues, tests and more, so agents write code the way the framework expects.

navree skills:install
Agent skills docs

AI SDK

Generate text or typed structs from Anthropic, OpenAI, Gemini, Mistral, Ollama or Bedrock, build agents with tools and memory, and fail over between models. Every capability has a fake for tests.

ai.structured::<ContractTerms>(prompt).await?
AI SDK docs

MCP servers

Turn service methods into MCP tools, resources and prompts, served over streamable HTTP or stdio, behind your auth and per-tool permissions.

#[mcp_tool(read_only)]
MCP servers docs

06 Testing

Test every layer, up to a real browser.

From unit tests with fakes to a real browser driving full user journeys.

Testing

Boot the real app in-process, call it without a network, and swap the queue, mail, clock, HTTP client and storage for fakes you can assert on.

app.acting_as(rep).get("/api/v1/deals")
Testing docs

Browser testing

Visit pages, fill forms, click and assert on what a user sees, over the Chrome DevTools Protocol, with a screenshot saved on every failure.

browser.visit(web.url("/login")).await?
Browser testing docs

Start

Start with all of it.

The SaaS starter kit writes an app with sign-in, workspaces, billing, settings and an admin panel, wired to Navree. Lighthouse and Logbook come with every new app; every other tool is one module away.

$ cargo install --git https://github.com/NavreeHQ/navree navree-cli$ navree new acme --kit saas
Explore the starter kitsInstall Navree