Why raindev.fyi exists

The gap nobody talks about

Computer science programs are good at teaching you to think algorithmically. You learn sorting algorithms, recursive functions, big-O notation, and how to traverse a binary tree.

But when you get your first real job, you're immediately confronted with things nobody taught you:

• How do I use Git without destroying the main branch?
• What's a pull request, and how do I write a good description?
• How do I deploy this to the internet?
• What's a .env file and why does everyone say not to commit it?
• Why is CI failing? What even is CI?
• What's Docker and do I actually need it?

These things aren't secrets. They're just not taught anywhere systematically. You pick them up from senior engineers, blog posts, StackOverflow answers, and painful mistakes in production.

What this site is

raindev.fyi is a practical, interactive field guide for the software engineering skills that live between "I can write code" and "I can ship software."

Each guide is written to be:

• Practical. Real commands, real workflows, real code.
• Interactive. Where possible, you can experiment directly in the page.
• Honest. We explain why things exist, not just what they are.
• Opinionated. We tell you what professionals actually do, not every possible option.

What this site is not

This is not a comprehensive documentation reference. It's a curated set of guides for the specific things that trip people up most when they're starting their career or trying to level up.

It's also not a "bootcamp in a website." We assume you can already write code. We're teaching you the layer on top of that.

How it's built

raindev.fyi is built with Astro, React, TypeScript, and MDX. It's a fully static site — no backend, no database, no tracking. It deploys to a CDN and loads fast.

The interactive widgets are built with React and embedded inside MDX files using Astro's island architecture — only the interactive parts hydrate JavaScript.