🚀 Nuvix

The open-source backend for secure, AI-ready applications.

Auth · Database · Storage · Messaging One platform. Self-host anywhere. Built for scale.

📖 Documentation · 💬 Discord · 🐛 Report Bug · ✨ Request Feature

---

What is Nuvix?

Most apps need the same backend building blocks: auth, a database, file storage, and messaging. The usual answer is 4 different vendors, 4 dashboards, and 4 billing pages before you write a single line of product code.

Nuvix replaces all of that.

✅ One unified backend ✅ Single permission model ✅ Fully self-hostable ✅ Security-first by design ✅ Built for AI-powered products

Stop managing multiple services. Start building products.

---

✨ Core Features

🔐 Authentication

Multi-tenant auth with user accounts, sessions, teams, and role-based access. Security isn't a config option—it's the default.

Includes: OAuth/Social login, MFA, session management, team roles, permissions

🗄️ Database

PostgreSQL under the hood. Three schema modes so you pick the right fit for each use case:

Mode	Best For	What You Get
📋 Document	Prototyping, MVPs	NoSQL-style flexibility, no SQL needed
⚙️ Managed	Production apps	Auto-generated CRUD + Row-Level Security policies
🔧 Unmanaged	Custom logic	Raw SQL, full control, no guardrails

Mix and match across the same project. All three share one unified API.

💾 Storage

Permission-aware file system with S3-compatible drivers or local storage. The same permission rules that govern your database govern your files.

Includes: Local & S3-compatible storage, permission inheritance, signed URLs, CDN-ready

📬 Messaging

Email, SMS, and push notifications through a single API. No need to wire up SendGrid, Twilio, and Firebase separately.

Includes: Email templates, SMS delivery, push notifications, delivery tracking, scheduling

🤖 AI-Ready

Purpose-built for AI products. Secure data layers, granular permissions, session management, and file handling for ML pipelines. Store embeddings, manage context, enforce access rules on every request.

---

🚀 Getting Started

⚡ Quickest Start: CLI

Get up and running in seconds with the Nuvix CLI.

curl -fsSL https://raw.githubusercontent.com/nuvix-dev/cli/main/install.sh | bash

Then run:

nuvix local init
nuvix local up

Open http://localhost:3000 and start building! 🎉

Requirements: Docker

🐳 Alternative: Docker Compose

git clone https://github.com/nuvix-dev/docker.git nuvix
cd nuvix
cp .env.example .env
docker compose up -d

📚 Full self-hosting instructions

💻 Local Development

bun install
bun run dev     # Start dev server with auto-reload
bun run test    # Run full test suite
bun run lint    # Format & lint with Biome

---

📦 Web SDK Installation

Use the Nuvix client SDK in your web projects:

npm

npm install @nuvix/client

bun

bun add @nuvix/client

Quick Usage

import { Client } from '@nuvix/client';

const nx = new Client()
    .setEndpoint('https://api.nuvix.in/v1')

// Authentication
const session = await nx.account.createAnonymousSession();

// Database queries
const todos = await nx.db.from('todos').select('*');

---

📐 Architecture

nuvix/
├── apps/
│   ├── server              Core API server (Fastify)
│   └── platform            Platform services
├── libs/
│   ├── core                Shared core logic
│   ├── pg-meta             PostgreSQL metadata layer
│   └── utils               Common utilities
├── configs/                Default configurations
├── docs/                   Documentation source
└── scripts/                Build & deployment scripts

---

🔒 Security Model

Security isn't an afterthought. Every request in Nuvix passes through the same permission pipeline.

• 🛡️ Managed Schemas - Auto-generate Row-Level Security policies. You don't write them by hand.
• 🔐 Project Isolation - Tenant data is separated at the database level.
• 🏠 Self-Hosted - Your data never leaves your infrastructure.
• ⚡ Unified Pipeline - Same permission model for database, storage, and messaging.

Security in Nuvix is always on. You don't enable it—it's the default.

---

🗺️ Roadmap

Exciting features coming soon:

• Realtime subscriptions (WebSocket support)
• Edge functions (Deploy functions at the edge)
• Python SDK
• Vector / embeddings support (AI-optimized)
• Multi-region self-hosting guide

Have an idea? Open an issue or join our Discord 💙

---

🤝 Contributing

We ❤️ contributions! Whether it's code, docs, bug reports, or ideas—we'd love your input.

1. 📖 Read the Contributing Guide
2. 🔍 Browse open issues
3. 💬 Join our Discord community

By submitting a pull request, you agree that Nuvix may use, modify, copy, and redistribute the contribution under terms of its choosing.

---

🐛 Bugs & Security

Found a bug? We'd appreciate a detailed issue on GitHub with steps to reproduce.

Found a security vulnerability? Please do not open a public issue. Email security@nuvix.in instead. We'll work with you to patch it before any public disclosure.

---

📚 Resources & Links

Resource	Purpose
📖 Documentation	Guides, API reference, tutorials, examples
🖥️ Console	Admin dashboard (self-hosted or managed)
💬 Discord Community	Get help, ask questions, share ideas
🐦 X / Twitter	Latest updates and announcements
📝 Blog	Tutorials, case studies, releases

---

📄 License

FSL-1.1-Apache-2.0

---

If Nuvix helps you build better products, drop a star ⭐

It helps us grow and lets the world know you find this useful.