npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@elysiumjs/styx

v0.18.1

Published

The command line tool of the Elysium.js framework: creates projects, generates code and runs app commands.

Readme

@elysiumjs/styx

The command line tool of the Elysium.js framework. It creates projects, generates code and runs your app's commands.

Installation

Install it globally to create projects and use it anywhere:

bun add -g @elysiumjs/styx

Projects also install it as a dev dependency (styx create does this). Inside a project, the global styx hands every command to the project's own copy, so each project runs the Styx version it was written for.

Standalone executables, which need neither Bun nor the package files, are built with bun run build:bin (current platform) or bun run build:bin --all (Linux, macOS and Windows). They embed the code stubs and project templates with Hephaestus.

Creating a project

styx create my-app

Without options, it asks for the template (single or multi module), the runtime, the modules, plugins and features. Options skip the prompts:

styx create my-app --template multi --modules users,billing --features prettier,hephaestus --git false

--install false writes the files without installing dependencies, --force replaces a folder that is not empty, and --yes takes the defaults for every option not given. bun create elysium my-app runs the same command.

Generating code

The generators write files from stubs and never start your app, so they work before the app can boot:

styx make:command --name SendReport
styx make:controller --name UserController
styx make:job --name ImportUsers
styx make:middleware --name AuthMiddleware
styx make:model --name User
styx make:repository --name UserRepository
styx make:seeder --name CountriesSeeder
styx make:service --name UserService
styx make:validator --name CreateUser
styx make:view --name Post
styx make:workflow --name FulfilOrder
styx module:new --name billing
styx module:rename --module billing --name payments

In a multi module project, pass --module <name>. Run styx help <command> for every option.

Files and module folders are named in kebab-case: styx make:service --name UserProfileService writes services/user-profile.service.ts. A validator holds only its schema unless you ask for its methods with --authorize and --validate, and a model declares supportTenancy only with --support-tenancy.

Typed clients

styx routes:generate writes the route types of the app to src/routes.gen.ts (set routes in .elysiumrc or pass --out, absolute or relative to the project, to change it). The file exports AppRoutes, for Eden:

import type { AppRoutes } from './routes.gen';

import { treaty } from '@elysia/eden';

const api = treaty<AppRoutes>('http://localhost:3000');
const { data } = await api.users({ id }).get();

The types come from the controller methods: the parameters decorated with @Http.param, @Http.query and @Http.body give the request types, and the return type gives the response type, so annotate the return type of methods that return different shapes. A route whose response is a view (PostView, PostView.list or PostView.page) takes its response type from the schema of the view. A view that no project file exports gives the route an unknown response, since the handler returns what the view renders, not what clients receive. The file holds types only and is written again by typecheck in new projects, so keep it out of git.

styx routes:check fails when a route declares no schema for its success response, so that clients and the OpenAPI document know what it returns. Set the response option of the route, either one schema or a map of statuses with at least one 2xx status. Server-sent events routes and routes answering 204 are left out. Run it in CI next to typecheck.

Every controller the modules of the app list is included, whatever declares it, as long as a file of the project exports it. When a decorator adds routes that are not methods of the class, or answers something else than the method returns, a route types contributor types them: a global service tagged Http.RouteTypes, active in development. Flow controllers are typed this way by AriadneModule.

@Service.register({ tags: [Http.RouteTypes], global: true, env: Environments.local })
export class PingRouteTypes implements HttpRouteTypesContributor {
	public supports(controller: Function) {
		return isPingable(controller);
	}

	public route(controller: Function, route: HttpRouteDescription, ref: HttpRouteTypeRef) {
		if (route.name === 'ping') return { response: '{ pong: true }' };
		return ref.method
			? {
					response: `Reply<ReturnType<${ref.method}>>`,
					imports: [{ from: './reply', names: ['Reply'] }]
				}
			: undefined;
	}
}

A contributor gives the type text of params, query, body and response, and leaves out the parts the method gives. A controller that no file exports, such as one a factory builds, is included when a contributor gives every type of its routes.

Running the app

Every other command loads the project's app (src/app.ts or index.ts) and runs there:

styx serve
styx migration:generate
styx migration:run
styx <your command>

These need @elysiumjs/styx in the project's dev dependencies.

Build tools

When the project installs @elysiumjs/hephaestus (as a dev dependency), its hephaestus:* commands are available through styx without adding anything to the app.

Listing commands

styx list
styx help <command>

Contributing

Issues for bugs and questions are welcome on GitHub. Pull requests are welcome too; they are reviewed to keep the framework consistent with its design.

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for more information.