CIC Baltic Metaverse

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.

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

1. Install Devbox shell and Nix Package manager:

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

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

Develop

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

pnpm dev

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

Useful Links

• GitHub Pages Documentation
• GitHub Project
• Cognitive Architect Project