Home Original page

GitHub - martinusdev/styleguide: Styleguide for Martinus, designed and created by Lighting Beetle.

Styleguide for Martinus, built with light-scripts.

Light is backbone for living styleguides.

Quick Start

Prerequisites

⚠️ Important

Do not run yarn directly. This project uses Docker for security isolation. Always use the wrapper scripts:

./npm.sh <command>    # Instead of: yarn <command>
./build.sh            # Instead of: yarn build
./serve.sh            # Instead of: yarn serve

Usage

# Install dependencies (Docker container)
./npm.sh install

# Development server with live reload
./serve.sh
# Open http://localhost:3000

# Production build
./build.sh
# Output in dist/

# Any yarn command
./npm.sh <command>

Installing / Updating Packages

# Add a specific package version
./npm.sh add package-name@1.2.3

# Update to latest version
./npm.sh add package-name@latest

# Check available updates
./npm.sh outdated

Architecture

Everything runs in Docker for security and reproducibility:

  • ✅ Isolated npm/yarn from host filesystem (supply chain protection)
  • ✅ Non-root user execution
  • ✅ Image optimization (gifsicle, optipng, mozjpeg)
  • ✅ Build takes ~30 seconds

Scripts

  • ./npm.sh - Run yarn commands
  • ./build.sh - Production build
  • ./serve.sh - Development server

All scripts available as root symlinks or in docker/ directory.

Documentation