Want to contribute a project? Here's how to get started.

For the full, detailed contributing guide, see CONTRIBUTING.md in the repository.

1. Fork the repository
2. Create your project in PROJECTS/{difficulty}/{project-name}/
3. Include a learn/ folder with educational documentation
4. Submit a pull request

Projects live in difficulty-based directories:

PROJECTS/
├── beginner/           # Basic tools, single-file scripts
├── intermediate/       # Multi-component systems, API integrations
└── advanced/           # Full-stack apps, distributed systems

Naming convention: lowercase, hyphenated (e.g., api-security-scanner, dns-lookup)

Every project must include a learn/ directory with five educational files:

Copy the template from .github/learn-folder-template/ to get started.

• Python: Use uv (not pip)
• Node.js: Use pnpm or Bun (not npm)

All Python code must pass:

• ruff check . (linting)
• mypy . (type checking)
• pylint src/ (additional linting)

Format with the repo's YAPF configuration (see TEMPLATES/.style.yapf).

• Reference actual code with filename:line format
• Include real-world examples (breaches, CVEs, incidents)
• Use ASCII diagrams for architecture
• Write in a clear, human voice (no marketing speak)
• Ground concepts in real-world security scenarios

Building a full-stack app? Use the included fullstack-template with FastAPI, React, Docker, and more.

Open an issue to discuss project ideas before starting.