New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started
l

lucky23m

npm

11.64K

total weekly downloads

Packages

Current Co-maintainers

Former Co-maintainers

17 packages

create-luckystack-app

Scaffold a new LuckyStack project. Run `npx create-luckystack-app my-app` to generate a starter with the recommended overlay layout, selected ORM/package-manager setup, and config files in place.

@luckystack/api

Type-safe API request handlers for LuckyStack. WebSocket-first via socket.io, with HTTP fallback. File-based routing, generated route map, integrated rate limiting, validation, hooks, and error-tracking tracing.

@luckystack/cli

LuckyStack project CLI. `npx luckystack add <feature>` installs an optional package AND injects the consumer-`src/` assets it needs (login pages, presence client mounts) that a plain `npm i` can't — the inverse of create-luckystack-app's optional-package

@luckystack/core

LuckyStack core: socket-first transport contracts, Redis adapter, project-config registry, hooks registry, response normalization, rate limiting, and shared session types. Foundation for every other @luckystack/* package.

@luckystack/cron

Leader-elected, Redis-backed cron scheduler for LuckyStack: declarative recurring jobs with one active leader under a healthy lease, overlap guards, jitter, per-tenant fan-out, and run stats. Best-effort lease semantics require idempotent jobs.

@luckystack/devkit

Dev-time tooling for LuckyStack: hot reload, route discovery, generated type-map emitter, Zod schema emitter, deploy-config validator CLI. Install as a devDependency in projects that build LuckyStack apps locally.

@luckystack/docs-ui

Dev-only API docs UI for LuckyStack. Mounts a Swagger-style page at /_docs that reads `apiDocs.generated.json` and renders every API route, its inputs/outputs, auth, and rate-limit metadata.

@luckystack/email

Pluggable transactional email for LuckyStack: Console (dev), Resend, and SMTP adapters with a registry-based plug-in pattern. Optional dep — install only when forgotPassword='framework' or you want to send transactional mail.

@luckystack/error-tracking

Optional, pluggable error-tracking integration for LuckyStack with Sentry, Datadog, and PostHog adapters. Auto-wires error/performance capture into the framework hook surface and is a safe no-op until a tracker is configured.

@luckystack/login

Authentication for LuckyStack: credentials + OAuth (Google/GitHub/Facebook/Discord/Microsoft/custom), Redis-backed sessions, single-session enforcement, password reset, 2FA, lifecycle hooks, and pluggable user/session adapters. Pairs with @luckystack/core

@luckystack/mcp

Read-only MCP server that exposes a LuckyStack project's committed AI context (decisions, dependency graph, routes, runbooks, capabilities) to Claude Code as queryable tools.

@luckystack/presence

Presence and activity awareness for LuckyStack: AFK detection, room-peer notifications, lifecycle (connect / disconnect / reconnect), single-session enforcement integration. For multiplayer and collaborative apps.

@luckystack/router

Standalone HTTP + WebSocket load-balancer for multi-instance LuckyStack deployments. Redis-backed health, boot-UUID handshake, service-key-aware routing, optional dev->staging fallback. Optional package — only needed for horizontal scale or split-environm

@luckystack/secret-manager

Rotation-aware secret resolver client for LuckyStack. Commit `.env` pointers (e.g. OPENAI_KEY=OPENAI_AUTHORIZATION_KEY_V5) instead of real secrets; at boot this client resolves them against an external append-only secret-manager server and writes the real

@luckystack/server

One-call server bootstrap for LuckyStack: HTTP + Socket.io + framework routes (api, sync, _health, /auth, uploads) wired together. Consumer's server.ts shrinks to ~20 lines.

@luckystack/sync

Real-time sync transport for LuckyStack: type-safe room-based fanout, server + per-client validation, streaming, optimistic offline queue. Server entry plus a browser-safe ./client subpath.

@luckystack/test-runner

Generated-type-driven test layers for LuckyStack: contract smoke (Zod-valid input), auth enforcement, rate-limit, and crash-resistance fuzz. Walks every endpoint via the generated apiMethodMap.