Introduction

Arcway is a convention-based JavaScript framework for building full-stack applications. It uses file-system conventions to auto-discover routes, jobs, events, and middleware — no manual wiring required.

Features

• File-based routing with middleware cascading and built-in schema validation
• Context-based infrastructure — db, log, events, cache, queue, files, mail passed via handler ctx
• Background jobs — cron, continuous, and on-demand with retry and backoff
• Event system — fire-and-forget async events with listener auto-discovery
• Database — Knex query builder with auto-migrations (SQLite, PostgreSQL, MySQL)
• Mail — send and queue emails via SMTP, with optional inbound IMAP polling
• SSR Pages — server-rendered React pages with layouts, middleware, and client-side hydration
• 50+ UI components — built on shadcn/ui patterns with Tailwind CSS
• Testing — Solo.test() boots in-memory with SQLite for fast integration tests
• Vault — password hashing, encryption, JWT, and ID generation
• Plugins & capabilities — package routes, jobs, tools, and migrations as plugins, wired together by a capability graph
• Derivable secrets — one master key derives every infrastructure secret via HKDF, with built-in rotation

Quick Start

mkdir my-app && cd my-app
npm init -y
npm install arcway
npx arcway dev

Arcway will create the project structure for you on first run. See the Getting Started guide for details.