LogicCore

LogicCore is a pnpm workspace for experimenting with generated worlds backed by SpacetimeDB. The repository contains a Next.js application, typed SpacetimeDB bindings, a tRPC API layer, and deterministic world generation utilities.

Workspace layout

apps/
  web/                  Next.js app router application
packages/
  spacetimedb/          Generated SpacetimeDB TypeScript bindings
  trpc/                 tRPC routers and server-side context
  world/                Deterministic world generation utilities

Tech stack

• pnpm workspaces
• Turbo task orchestration
• Next.js 16 and React 19
• tRPC with TanStack Query
• SpacetimeDB for world persistence and live data
• Ultracite for linting and formatting
• Vitest for package tests

Getting started

Install dependencies:

pnpm install

Copy the example environment file and fill in the SpacetimeDB values:

cp .env.example .env

Required server-side variables:

SPACETIMEDB_HOST=
SPACETIMEDB_DB_NAME=

Optional client-side variables override the browser connection defaults used by the web app:

NEXT_PUBLIC_SPACETIMEDB_HOST=
NEXT_PUBLIC_SPACETIMEDB_DB_NAME=

Start the development servers:

pnpm dev

The web app runs from apps/web and is available at http://localhost:3000 by default.

Common commands

Run these commands from the repository root:

pnpm dev        # Start workspace development tasks
pnpm build      # Build the workspace
pnpm test       # Run package tests
pnpm check      # Check formatting and lint rules with Ultracite
pnpm fix        # Auto-fix formatting and lint issues with Ultracite
pnpm generate   # Regenerate SpacetimeDB bindings

Application routes

• /worlds lists worlds from SpacetimeDB.
• /worlds/[slug] is the world detail route.
• /admin/world/generate provides a form for creating a world from a numeric seed.

Packages

@logiccore/world

Provides deterministic world generation. The exported generateWorld function builds chunk data from a seed, world size, and chunk size, including biome, geology, richness, ore modifiers, and generated region names.

@logiccore/spacetimedb

Contains generated TypeScript bindings for the SpacetimeDB module. Regenerate these files with:

pnpm generate

@logiccore/trpc

Defines the tRPC API surface used by the web app. Current world operations include listing worlds, adding a world by seed, and deleting a world by id.

Code quality

This repository uses Ultracite for formatting and linting:

pnpm check
pnpm fix

Run pnpm check before opening a pull request.