Skip to content

Latest commit

 

History

118 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Orbital Express

An opinionated Express.js + Sequelize framework for building production-grade APIs fast. Feature-folder architecture, generator-first workflow, built-in auth, background jobs, real-time, i18n, and AI-native skills.

→ Full documentation: hackbyrd.github.io/orbital-express


Quick start

npx create-orbital-app my-api

What it is

  • Feature-folder architecture — model, routes, actions, tasks, tests, and i18n for a feature live in one folder under app/
  • Generator-first and non-destructiveyarn gen Feature scaffolds with validated names, exclusive file creation, and deterministic indexes; conflicts abort before writes; yarn del removes cleanly
  • Convention-enforced — every feature has the complete standard structure; yarn repair Feature --dry-run previews non-destructive repair and yarn conventions:check validates it
  • Auth out of the box — access + revocable refresh tokens, multiple user types, Google OAuth
  • Background jobs — Bull/Redis queue with typed task files
  • Real-time — Socket.IO with JWT authentication
  • AI-native — skills for Claude Code, Cursor rules, GitHub Copilot instructions, MCP server

Plan and get sign-off before scaffolding or edits, for both new and existing features. Always scaffold when available. After scaffold cleanup, preview yarn repair <Feature> --dry-run, apply yarn repair <Feature>, then run yarn conventions:check. Repair never overwrites existing files or invents ambiguous business wiring. Root routes, models, workers, and errors auto-discover feature folders; actions live in app/<Feature>/actions/. Extra domain files are allowed, but model-only/table-only feature folders are not.

Links

About

A better way to organize and develop on your Express.js Node.js application. Built for developers who need a little bit more structure and for helping engineering teams scale from 0 to 1.

Resources

Contributing

Stars

14 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages