Turborepo for a browser-based collaborative metaverse platform built with WebXR, Three.js, and real-time communication. Supports multi-user interaction, avatars, spatial audio, and modular components for extensible 3D environments.

What's inside?

This Turborepo includes the following packages/apps:

Apps

constellation is the central knowledge hub for our monorepo universe. Powered by Docusaurus, it maps out architecture, guides, decisions, and best practices — like a star map for navigating the project’s galaxies (build, github pages output ./docs).
nebula is the vibrant frontend layer of our monorepo, crafted with Vite/React to deliver lightning-fast development and optimized production builds. It creates immersive user experiences with modern tooling and smooth interactivity.
singularity is the backend powerhouse of our monorepo, built with Fastify for blazing-fast, lightweight, and scalable server-side APIs. It handles core business logic, data processing, and integrations with performance and developer experience in mind.
horizon is the quality assurance frontier of our monorepo, powered by Playwright to ensure seamless end-to-end testing across all applications. It stands at the edge of deployment, validating user journeys and system integrity with automated precision and comprehensive coverage.

Packages

@metaverse/stardust is the shimmering design system of our monorepo universe — a shared React component library that powers both nebula (frontend) and constellation (documentation). Like cosmic dust forming stars, stardust brings consistency, beauty, and reusability to every interface across our galaxy of apps.
@metaverse/eslint-config: eslint configurations (includes eslint-config-next and eslint-config-prettier)
@metaverse/typescript-config: tsconfig.jsons used throughout the monorepo

Each package/app is 100% TypeScript.

Local setup

Install Devbox shell and Nix Package manager:

curl -fsSL https://get.jetify.com/devbox | bash

Initialize Devbox shell cd metaverse && devbox shell, this will create a working environment and install all necessary runtimes as well as pnpm packages.
Create .env file by running cp .env.example .env.

Develop

To develop all apps and packages, run the following commands:

pnpm dev

Chrome/WebGL note: If the metaverse UI is blank or WebXR/WebGL features don’t appear, your browser may be running without GPU acceleration. In Chrome go to Settings -> System -> “Use hardware acceleration when available” -> Relaunch

Build

To build all apps and packages, run the following commands:

pnpm build

Build Docs

To build documentation, run the following commands:

pnpm build:docs

README.md Unescape Escape

CIC Baltic Metaverse