skills.rest
BlocUnited-LLC
BlocUnited-LLCOFFICIAL
Explore all skills by this author →
GitHub

setup

Set up a Mozaiks development environment with dependencies and environment variables.

14|1|Updated Jan 8, 2026
Search Tags:#environment variables#docker compose#development setup#studio#frontend backend#local verification#mozaiks
One-click install
npx skills add https://github.com/BlocUnited-LLC/mozaiks --skill setup-blocunited-llc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/BlocUnited-LLC/mozaiks/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/BlocUnited-LLC/mozaiks --skill setup-blocunited-llc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helping you get Mozaiks running the first time without getting stuck on missing dependencies, misconfigured environment variables, or broken local services.

Core Features & Use Cases

  • Environment initialization: Guides you to copy and configure .env (including optional OpenAI API key handling) so builds can run safely.
  • Local dev dependencies: Steps through installing Python dev dependencies and Node frontend dependencies required for the Studio UI.
  • Working local stack + verification: Starts the preferred Studio backend/frontend workflow and verifies health endpoints and the correct first-party builder app bundle.
  • Use cases: Ideal when onboarding to the repository, troubleshooting local developer setup, or switching between monolithic Studio mode and split backend/frontend terminals.

Quick Start

Run the setup skill to install prerequisites, configure .env, start the local Studio stack, and confirm the frontend loads at http://localhost:3000/apps with backend health at http://localhost:8000/api/health.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local development environment from a fresh repository clone?▼

Local development setup from a fresh clone requires installing Python dev extras, Node frontend dependencies, configuring `.env`, and starting Docker to verify the Studio stack and app bundle.

What dependencies do I need to run the Studio frontend and backend locally?▼

Running the Studio frontend and backend locally requires Docker, Python 3.11+, and Node 18+ with npm to install necessary `web_shell` dependencies and start the unified or split workflows.

How do I configure environment variables for a new local development setup?▼

Environment variables are configured by copying and setting up the `.env` file in the repository root, including optional OpenAI API key handling, to ensure local builds and services run safely.

How can I verify that my local Studio backend and frontend services are working?▼

Verify local Studio services by checking the backend health endpoint at `localhost:8000/api/health` and confirming the frontend loads the expected builder app bundle at `localhost:3000/apps`.

Can I switch between unified and split backend/frontend workflows during local setup?▼

You can switch between monolithic Studio mode and split backend/frontend terminals during local setup by starting the preferred workflow using `scripts/run-studio.ps1` to manage your services.

Why is my local development setup failing after a fresh clone?▼

Local development setup fails after a fresh clone due to missing runtime dependencies, unconfigured `.env` environment variables, or broken local ports, which this setup process resolves systematically.

Related Skills

Explore More Software Engineering Skills→
obenlandobenland

wp-env

Automate Docker-based WordPress local environments with wp-env.

Community
Advanced
dezverevdezverev

animal-kernel-web-dev

Start the AnimalKernel.Web dev server and verify UI with Cursor's browser.

Community
Intermediate
elasticdotventureselasticdotventures
14

direnv-pattern

Automate loading of per-project environment variables via direnv and dotenv with Rust validation.

Community
Advanced
frostaurafrostaura
32

start-projects

Automate project setup and run processes with docker-compose workflows.

Community
Intermediate