Nuvex is the ultimate production-ready, TypeScript-first 3-layer storage SDK for Node.js applications. Combining the speed of memory cache, the reliability of Redis, and the persistence of PostgreSQL — all with one simple API and zero configuration hassle. Born from real-world development challenges and proven in production environments, Nuvex delivers enterprise-grade storage with intelligent caching that actually works.
The first storage SDK with built-in automatic data promotion/demotion, comprehensive health monitoring, and backup/restore capabilities. Stop wrestling with complex storage configurations and start building amazing applications with confidence. Whether you're creating high-performance APIs, developing microservices, or deploying production servers, Nuvex provides intelligent multi-layer storage that scales with your application's growth — from your first prototype to handling millions of requests across distributed systems.
Tired of juggling Redis, PostgreSQL, and in-memory caches? You're not alone.
Every developer has been there: your app is slow because you're hitting the database for every request. You add Redis, now you're managing cache invalidation. You add memory caching, now you're dealing with three different APIs and complex fallback logic. One service goes down, your entire storage layer breaks.
Nuvex solves this once and for all:
- 🎯 One API, Zero Headaches: Write
storage.set()andstorage.get()— Nuvex handles Memory → Redis → PostgreSQL automatically - ⚡ Performance That Just Works: Sub-millisecond access for hot data, with intelligent promotion keeping your most-used data blazing fast
- 🛡️ Production-Grade Reliability: Battle-tested with automatic error recovery and graceful fallbacks when services go down
- 📊 Built-in Observability: Real-time metrics and health monitoring so you know exactly what's happening
- 💪 TypeScript-First DX: Full type safety and excellent IntelliSense that makes coding a joy
- 🔧 Zero Configuration: Works perfectly out of the box — no complex setup, no YAML files, no DevOps nightmares
The result? You focus on building features while Nuvex handles the storage complexity. From prototype to production, from thousands to millions of requests — storage that scales with your ambitions.
Ready to 10x your storage performance? Get started now ⚡
💎 Platinum Sponsor |
|---|
 |
Unthread Streamlined support ticketing for modern teams. |
Open source development is resource-intensive. These sponsored ads help keep Log Engine free and actively maintained while connecting you with tools and services that support open-source development.
npm install nuvex pg redisimport { NuvexClient } from 'nuvex';
// Initialize once, use everywhere
const storage = await NuvexClient.initialize({
postgres: {
host: 'localhost',
port: 5432,
database: 'myapp',
user: 'postgres',
password: 'password'
},
redis: { url: 'redis://localhost:6379' } // Optional but recommended
});
// Simple, powerful API
await storage.set('user:123', { name: 'John', email: '[email protected]' });
const user = await storage.get('user:123');
await storage.delete('user:123');
// Namespace your data
await storage.setNamespaced('sessions', 'abc123', { userId: 789, expires: Date.now() + 3600000 });
const session = await storage.getNamespaced('sessions', 'abc123');
// Batch operations for efficiency
const results = await storage.setBatch([
{ operation: 'set', key: 'product:1', value: { name: 'iPhone', price: 999 } },
{ operation: 'set', key: 'product:2', value: { name: 'MacBook', price: 1999 } }
]);
// Health monitoring
const health = await storage.healthCheck();
console.log('Storage healthy:', health.overall);npm install nuvex pg redis- 🌐 Web APIs: Session management, response caching, rate limiting
- 🛒 E-commerce: Product catalogs, shopping carts, user preferences
- 🎮 Gaming: Player data, leaderboards, real-time game state
- 🤖 Bots & Automation: User state, conversation flow, command history
- 📱 Mobile Backends: User profiles, app data, push notifications
- 🏢 Enterprise: Configuration management, temporary data, metrics
- 📊 Analytics: Event storage, metrics aggregation, reporting data
const config = {
postgres: {
host: 'localhost',
port: 5432,
database: 'myapp',
user: 'postgres',
password: 'password'
},
redis: { url: 'redis://localhost:6379' }, // Optional but recommended
memory: { ttl: 86400000, maxSize: 10000 }, // Optional
logging: { enabled: true } // Optional
};// Basic operations
await storage.set('key', value, { ttl: 3600 });
const data = await storage.get('key');
await storage.delete('key');
await storage.exists('key');
// Namespace operations
await storage.setNamespaced('users', '123', userData);
const user = await storage.getNamespaced('users', '123');
// Batch operations
const results = await storage.setBatch([
{ operation: 'set', key: 'key1', value: 'value1' },
{ operation: 'get', key: 'key2' }
]);
// Atomic operations
const newValue = await storage.increment('counter', 5);
await storage.decrement('counter', 2);// Health monitoring
const health = await storage.healthCheck();
console.log('All systems:', health.overall ? '✅' : '❌');
// Performance metrics
const metrics = storage.getMetrics();
console.log(`Cache hit rate: ${(metrics.memoryHits / metrics.totalOperations * 100).toFixed(2)}%`);
// Backup & restore
const backupId = await storage.backup('my-backup', { compression: true });
await storage.restore('my-backup', { clearExisting: false });
// Query operations
const results = await storage.query({
pattern: 'user:*',
limit: 100,
sortBy: 'createdAt'
});Nuvex supports any logger that implements the simple interface:
// With Winston
import winston from 'winston';
const logger = winston.createLogger({
level: 'info',
format: winston.format.json(),
transports: [new winston.transports.Console()]
});
// With Pino
import pino from 'pino';
const logger = pino({ level: 'info' });
// With Console (development)
const logger = console;
// Use any logger
const storage = new Nuvex({
postgres: { /* ... */ },
logging: { enabled: true, logger }
});Nuvex supports pluggable logging with any logger that implements the simple interface.
@wgtechlabs/log-engine is specifically designed to work seamlessly with Nuvex:
import { LogEngine } from '@wgtechlabs/log-engine';
import { Nuvex } from 'nuvex';
// One-time configuration
LogEngine.configure({
level: 'info',
service: 'my-app',
structured: true,
colorize: true
});
const storage = new Nuvex({
postgres: { /* config */ },
logging: {
enabled: true,
logger: LogEngine,
includeMetrics: true // Cache hit/miss rates
}
});Benefits of log-engine with Nuvex:
- 🎯 Structured Logging - Perfect for monitoring Nuvex metrics
- ⚡ High Performance - Minimal overhead for storage operations
- 🔧 Easy Configuration - Works out of the box
- 📊 Rich Context - Detailed operation metadata
// Winston
import winston from 'winston';
const logger = winston.createLogger({ level: 'info' });
// Pino
import pino from 'pino';
const logger = pino();
// Console (development)
const logger = console;
// Custom logger (just implement the interface)
const logger = {
debug: (msg, meta) => { /* your implementation */ },
info: (msg, meta) => { /* your implementation */ },
warn: (msg, meta) => { /* your implementation */ },
error: (msg, meta) => { /* your implementation */ }
};// Basic CRUD operations
await storage.set(key, value, options?);
await storage.get(key, options?);
await storage.delete(key);
await storage.exists(key);
// Batch operations
await storage.setBatch([
{ operation: 'set', key: 'key1', value: 'value1' },
{ operation: 'set', key: 'key2', value: 'value2' }
]);
// Query operations
const results = await storage.query({
pattern: 'user:*',
limit: 10,
sortBy: 'createdAt'
});// Force specific storage layer
await storage.set('key', value, { layer: StorageLayer.POSTGRES });
// Skip cache layers
await storage.get('key', { skipCache: true });
// Layer management
await storage.promote('key', StorageLayer.MEMORY);
await storage.demote('key', StorageLayer.POSTGRES);
// Metrics and monitoring
const metrics = storage.getMetrics();
const health = await storage.healthCheck();3-Layer Architecture → Automatic Optimization → Lightning Fast
- Memory (< 1ms) → Redis (1-5ms) → PostgreSQL (5-50ms)
- Smart promotion: Hot data moves to faster layers automatically
- Graceful fallback: If Redis is down, PostgreSQL takes over seamlessly
- Zero config: Works perfectly out of the box with sensible defaults
- 💬 GitHub Discussions - Ask questions, share ideas
- 🐛 Issues - Report bugs, request features
- 📖 Documentation - Complete API reference
- ⭐ Star this repo - Show your support!
We ❤️ contributions! Here's how you can help:
- 🐛 Report bugs - Found an issue? Open an issue
- 💡 Suggest features - Have ideas? Start a discussion
- 📝 Improve docs - Help make our documentation better
- 🔧 Submit PRs - Check out our contributing guide to get started
Need assistance? Here's how to get support:
- Community Support: Check the Help & Support discussions
- Ask Questions: Create a new discussion
- Security Issues: Follow our security policy for responsible disclosure
Like this project? Leave a star! ⭐⭐⭐⭐⭐
There are several ways you can support this project:
- Become a sponsor and get some perks! 💖
- Buy me a coffee if you just love what I do! ☕
Found this project helpful? Consider nominating me (@warengonzaga) for the GitHub Star program! This recognition supports ongoing development of this project and my other open-source projects. GitHub Stars are recognized for their significant contributions to the developer community - your nomination makes a difference and encourages continued innovation!
I'm committed to providing a welcoming and inclusive environment for all contributors and users. Please review the project's Code of Conduct to understand the community standards and expectations for participation.
MIT License — see LICENSE for details.
This project is created by Waren Gonzaga at WG Technology Labs, with the help of awesome contributors.
💻 with ❤️ by Waren Gonzaga at WG Technology Labs, and Him 🙏