A free, hands-on platform for mastering distributed systems: interactive simulators (cache, circuit breaker, load balancer, sharding, consensus, and more), real-world case studies, and a structured learning roadmap.

English · Português

Dinamos is a single-page web app backed by a small HTTP API. Instead of describing distributed-systems behavior in prose, it lets you run it: live telemetry, request flows, failure injection, and an interactive system editor you can build and stress-test.

• Node.js 20+ and npm
• A PostgreSQL database (local or hosted, e.g. Supabase/Neon)
• A Firebase project (for authentication)

The following are optional — leave the related env vars empty to disable the feature locally: OpenAI, Resend, and Stripe.

# 1. Clone
git clone https://github.com/flaviojmendes/dinamos.git
cd dinamos

# 2. Install dependencies
npm install

# 3. Configure environment variables
cp .env.example .env
# then fill in the values in .env (see comments in the file)

The frontend and the API run as two processes:

# Terminal 1 — API (http://localhost:8787)
npm run dev:api

# Terminal 2 — frontend (http://localhost:5173), proxied to the local API
API_PROXY_TARGET=http://localhost:8787 npm run dev

If you omit API_PROXY_TARGET, the Vite dev server proxies /api to the deployed backend instead of your local one.

Schema is managed with Drizzle. Common commands:

npm run db:push          # push the current schema to the database
npm run db:generate      # generate a new migration from schema changes
npm run db:migrate       # apply migrations
npm run db:seed-content  # seed module/page content

npm test            # run the test suite once
npm run test:watch  # watch mode
npm run typecheck   # type-check frontend + API

npm run build       # type-check + production build into dist/
npm run preview     # preview the production build locally

api/                 Hono API: routes, middleware, db (Drizzle schema + migrations), lib
public/              Static assets and policy pages
src/
  components/        Feature components + interactive simulators
  app/               App shell: pages, contexts, admin area
  config/            Registries (content, simulators, i18n, firebase)
  content/           MDX authoring (see src/content/AUTHORING.md)
  contexts/          React contexts (auth, theme, content)
  utils/, hooks/     Shared helpers

Contributions are welcome! Please read CONTRIBUTING.md (English) or CONTRIBUTING.pt-BR.md (Portuguese) and our Code of Conduct before opening an issue or PR.

Released under the MIT License.

Dinamos é uma plataforma gratuita e prática para dominar sistemas distribuídos: simuladores interativos (cache, circuit breaker, balanceador de carga, sharding, consenso e mais), estudos de caso reais e um roteiro de aprendizado estruturado. Em vez de descrever o comportamento dos sistemas em texto, aqui você executa o sistema.

• Node.js 20+ e npm
• Um banco PostgreSQL (local ou hospedado, ex.: Supabase/Neon)
• Um projeto Firebase (para autenticação)

OpenAI, Resend e Stripe são opcionais — deixe as variáveis de ambiente correspondentes vazias para desabilitar localmente.

git clone https://github.com/flaviojmendes/dinamos.git
cd dinamos
npm install
cp .env.example .env   # preencha os valores em .env

# Terminal 1 — API (http://localhost:8787)
npm run dev:api

# Terminal 2 — frontend (http://localhost:5173)
API_PROXY_TARGET=http://localhost:8787 npm run dev

npm run db:push          # aplica o schema atual no banco
npm run db:generate      # gera uma migration a partir das mudanças de schema
npm run db:migrate       # aplica as migrations
npm run db:seed-content  # popula o conteúdo (módulos/páginas)

npm test            # roda a suíte de testes
npm run typecheck   # verifica os tipos (frontend + API)

Contribuições são bem-vindas! Leia o CONTRIBUTING.pt-BR.md e o nosso Código de Conduta antes de abrir uma issue ou PR.

Distribuído sob a Licença MIT.