---

Overview

Stars Components is a monorepo containing 23 independently versioned TypeScript packages under the @wolfstar npm scope. Its core is @wolfstar/http-framework, a framework for Discord applications that receive interactions over HTTP—well suited to webhook and serverless deployments without a persistent Gateway connection.

The ecosystem also includes a project scaffolder, development CLI, interaction test utilities, integrations, and reusable tooling. Optional features such as REST routes, i18n, logging transports, and modular subcommands are available from the official plugin repository.

Technology Stack:

• Language: TypeScript (Node.js ^22.11 || ^24 || >=26)
• Package Manager: pnpm with workspaces
• Monorepo Runner: Turbo
• Testing: Vitest
• Linting: oxlint with oxfmt
• Release: Changesets v3 (independent semver per package)

---

Quick Start

Prerequisites

• Node.js ^22.11, ^24, or >=26
• pnpm (automatically pinned via corepack)

Installation

# Clone the repository
git clone https://github.com/wolfstar-project/stars-components.git
cd stars-components

# Install dependencies (uses pnpm workspaces)
pnpm install

# Run quality gates
pnpm lint      # oxlint + oxfmt check
pnpm build     # tsdown for each package
pnpm typecheck # TypeScript check (uses built declarations)
pnpm test      # vitest

Important: Run pnpm build before pnpm typecheck, as typecheck resolves cross-package imports against built dist/*.d.ts files.

Using a Package

Each package is independently published to npm under @wolfstar/ scope. Install any package directly:

# Example: Install the HTTP framework and environment utilities
npm install @wolfstar/http-framework @wolfstar/env-utilities
# or with pnpm
pnpm add @wolfstar/http-framework @wolfstar/env-utilities

---

Packages

---

Examples

The examples/ directory contains runnable bot samples using the HTTP Framework and related utilities. Examples are provided in both TypeScript and JavaScript (ESM).

Running an Example

# Install all dependencies
pnpm install

# Build all packages
pnpm build

# Setup environment for the basic example
cp examples/basic/.env.example examples/basic/src/.env

# Run a TypeScript example (with live reloading)
pnpm --filter basic dev

# Or run a plain JavaScript example (no build step)
pnpm --filter basic-js dev

For a complete list of available examples, see examples/README.md.

---

Development

Contributing

Contributions are welcome! Please read our Contributing Guide before submitting a pull request.

Key Conventions:

• Commits: Conventional Commits using cz (commitizen)
• Changes: Use pnpm changeset to add changesets; do not edit package.json#version or CHANGELOG.md directly (these are managed by Changesets)
• Release Process: Changesets automatically publishes independent versions for affected packages

Benchmarks

Performance-sensitive code paths are benchmarked in benchmarks/ with tinybench and tracked continuously by CodSpeed. Run them locally with pnpm bench.

Contributors

Thank you to all contributors who have helped make Stars Components better!

Development Environment

You can contribute without a local setup by using cloud-based development environments:

---

License

Stars Components is licensed under the Apache License 2.0. See the LICENSE file for details.

Copyright 2022 Wolfstar Project

---

Resources

• GitHub: https://github.com/wolfstar-project/stars-components
• npm Packages: https://www.npmjs.com/org/wolfstar
• Website: https://stars-components.js.org
• Issues & Discussions: https://github.com/wolfstar-project/stars-components/issues