Learn how to build a dedicated API documentation repository that becomes your team's single source of truth, enabling true contract-first development.

Evil Martians offers insights into software development, web design, and digital product strategy, providing articles, case studies, and open-source contributions to help businesses innovate and deliver exceptional user experiences. By exploring Evil Martians' curated content, developers can learn about Ruby on Rails development, frontend frameworks, and modern web technologies for building scalable and maintainable applications. Whether you're launching a new product, redesigning a website, or optimizing user interfaces, Evil Martians offers resources to bring your ideas to life and achieve digital success.

Martian Chronicles

A practical guide to implementing contract-first API development using a dedicated documentation repository. Demonstrates building a modular OpenAPI specification system with Vite, React, and TypeScript, featuring automatic YAML compilation, validation, and hot-reloading. The approach separates API contracts from backend code, enabling parallel frontend and backend development while maintaining a single source of truth. Includes a complete working example of a Mars hotel booking API with organized file structure, custom Vite plugin for YAML processing, and Swagger UI integration.

Contract shock therapy: the way to API-first documentation bliss—Martian Chronicles, Evil Martians’ team blog

API contracts and everything I wish I knew: a frontend survival guide

Handwritten specs in a separate repository? Why?

Writing the contract: source files that scale

The auto-refresh system: building a YAML import plugin

Let there be docs! A documentation-first approach to Rails API development