Development

Development

PalCenter is an open-source TypeScript monorepo:

• apps/frontend — Next.js and Mantine web interface
• apps/api — Fastify API and Palworld REST integration
• packages — shared workspace configuration
• .github/workflows — validation and release automation

Repository: shanebionic/palcenter

Local setup

Requirements:

• Node.js 22.13 or newer
• pnpm 9
• Git

git clone https://github.com/shanebionic/palcenter.git
cd palcenter
corepack enable
pnpm install
pnpm dev

The frontend runs on port 3000 and the API on port 3001.

Validation

pnpm check-types
pnpm lint
pnpm build
pnpm --filter @palcenter/api test

Build the production container with:

docker build -t palcenter:local .

Release overview

Version tags such as v1.1.1 trigger GitHub Actions. The workflow validates the application, builds multi-platform Docker images, publishes the release and latest tags to GitHub Container Registry, and creates or updates the GitHub release.

Do not place credentials or production data in issues, tests, or commits.