chubbyts-framework-skeleton

Description

A minimal skeleton for chubbyts-framework.

Requirements

• node: 22
• @chubbyts/chubbyts-dic: ^2.2.0
• @chubbyts/chubbyts-dic-config: ^2.2.0
• @chubbyts/chubbyts-dic-types: ^2.2.0
• @chubbyts/chubbyts-framework: ^3.1.3
• @chubbyts/chubbyts-framework-router-path-to-regexp: ^3.1.3
• @chubbyts/chubbyts-http-error: ^3.3.0
• @chubbyts/chubbyts-log-types: ^3.2.0
• @chubbyts/chubbyts-pino-adapter: ^3.2.0
• @chubbyts/chubbyts-undici-server: ^1.1.3
• @chubbyts/chubbyts-undici-server-node: ^1.1.3
• commander: ^14.0.3
• pino: ^10.3.1

Environment

Add the following environment variable to your system, for example within ~/.bashrc or ~/.zshrc:

export USER_ID=$(id -u)
export GROUP_ID=$(id -g)

Mount points

bash

touch ~/.bash_docker
touch ~/.bash_history

zsh

touch ~/.zsh_docker
touch ~/.zsh_history

git

touch ~/.gitconfig
touch ~/.gitignore

npm

touch ~/.npmrc

claude - coding agent

[ ! -f ~/.claude.json ] && echo '{}' > ~/.claude.json
mkdir -p ~/.claude
[ ! -f ~/.claude/.credentials.json ] && echo '{}' > ~/.claude/.credentials.json
[ ! -f ~/.claude/settings.json ] && echo '{}' > ~/.claude/settings.json

opencode - coding agent

mkdir -p ~/.config/opencode
[ ! -f ~/.local/share/opencode/auth.json ] && echo '{}' > ~/.config/opencode/tui.json
mkdir -p ~/.local/share/opencode
[ ! -f ~/.local/share/opencode/auth.json ] && echo '{}' > ~/.local/share/opencode/auth.json

pi - coding agent

mkdir -p ~/.pi/agent
[ ! -f ~/.pi/agent/auth.json ] && echo '{}' > ~/.pi/agent/auth.json

Docker

docker-compose up -d
docker-compose exec node bash

Installation

pnpm start

Urls

• GET https://localhost/ping

Structure

Command

Commands is code that is meant to be executed on command line.

• src/command.ts

Handler

Handler alias Controller, or Controller actions to be more precise.

• src/handler.ts

ServiceFactory

Service factories are the glue code of the dependeny injection container.

• src/service-factory.ts

Copyright

2026 Dominik Zogg