Skip to content

paruff/fawkes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2,168 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Fawkes - Internal Product Delivery Platform

πŸŽ“ Learn platform engineering while building a world-class delivery platform

Fawkes Logo

Start Learning β†’ Β· Deploy Platform β†’ Β· Read Docs β†’ Β· Join Community β†’

License Kubernetes Contributions Stars

Code Quality Pre-commit Security Coverage threshold enforced in CI β€” see code-quality workflow


What Makes Fawkes Different?

Fawkes isn't just another Internal Developer Platformβ€”it's a complete Internal Product Delivery Platform that uniquely combines:

πŸŽ“ Immersive Dojo Learning

Learn platform engineering by doing, not just reading. Progress through belt levels while building real skills on production-grade infrastructure.

πŸš€ Complete Product Delivery

Everything teams need: infrastructure, CI/CD, collaboration, project management, observability, and securityβ€”all integrated, all open source.

πŸ“Š DORA-Driven by Design

Four key metrics automated from day one. Measure what matters, improve continuously, achieve elite performance.

🀝 Unified Experience

One platform, one login, one interface. No more context switching between a dozen tools.


πŸš€ AWS Activate Project

Fawkes is applying for the AWS Activate program to accelerate development and provide free learning resources to the platform engineering community. We're building an AWS-native Internal Delivery Platform that helps organizations achieve Elite DORA performance.

Why AWS?

  • Native integration with EKS, RDS, S3, and CloudWatch
  • Scalable, secure infrastructure for enterprise workloads
  • Cost-effective for startups and growing companies
  • Best-in-class Kubernetes support with Amazon EKS

AWS Services Used: EKS, RDS, S3, ALB, CloudWatch, X-Ray, Secrets Manager, IAM, VPC, Certificate Manager

Apply for AWS Activate | See our AWS Cost Estimation

AWS Activate Application

πŸ“Š AWS Cost Estimation πŸ“ˆ Business Case & Value Proposition


πŸ₯‹ The Fawkes Dojo: Learn by Doing

The Problem: Platform engineering skills are in high demand but hard to acquire. Reading docs β‰  real expertise.

The Fawkes Solution: An immersive learning environment where you build actual platform skills on production-like infrastructure.

Belt Progression System

Progress through 5 belt levels, each building on the last:

πŸ₯‹ White Belt (8 hours)      β†’  Platform Fundamentals
   ↓ Deploy your first app, understand DORA metrics

🟑 Yellow Belt (8 hours)     β†’  CI/CD Mastery
   ↓ Build pipelines, implement security scanning

🟒 Green Belt (8 hours)      β†’  GitOps & Deployment
   ↓ Master blue-green and canary deployments

🟀 Brown Belt (8 hours)      β†’  Observability & SRE
   ↓ Configure full observability, respond to incidents

⚫ Black Belt (8 hours)      β†’  Platform Architecture
   ↓ Design platforms, mentor others

Total: 40 hours from novice to platform architect

What You Get

βœ… Hands-On Labs - Practice in isolated, safe environments βœ… Immediate Feedback - Auto-graded labs, real-time validation βœ… Production Skills - Same tools used in enterprise platforms βœ… Recognized Credentials - Digital badges and certificates βœ… Community Learning - Learn with peers, get mentorship βœ… Platform Engineering University Integration - Aligned with industry certifications

Start Your Dojo Journey β†’


πŸš€ A Complete Product Delivery Platform

Unlike infrastructure-only solutions, Fawkes provides everything product teams need:

Infrastructure & Delivery

  • Kubernetes Orchestration - Multi-cloud ready (AWS, Azure, GCP)
  • Infrastructure as Code - Terraform and Crossplane
  • CI/CD Pipelines - Jenkins with golden path templates
  • GitOps Workflows - ArgoCD for declarative deployments
  • Progressive Delivery - Blue-green, canary, automated rollback

Collaboration & Planning

  • Team Chat - Mattermost for real-time collaboration
  • Project Management - Focalboard (Notion-like) for sprints and roadmaps
  • ChatOps - Deploy and manage from chat
  • Platform Notifications - CI/CD, deployments, alerts in chat

Observability & Insights

  • DORA Metrics - Automated collection of all 4 key metrics
  • Metrics & Dashboards - Prometheus and Grafana
  • Distributed Tracing - Jaeger with OpenTelemetry
  • Log Aggregation - OpenSearch with Fluent Bit
  • Custom Dashboards - Team-level visibility

Security & Compliance

  • πŸ”’ Security Plane - Comprehensive security framework with SBOM, signing, and policy enforcement
  • Security Scanning - SonarQube (SAST), Trivy (containers), Gitleaks (secrets)
  • Automated Secrets Detection - Pre-commit hooks and CI/CD pipeline scanning
  • Policy Enforcement - Kyverno for Kubernetes policies + OPA/Rego for CI/CD
  • SBOM Generation - Syft-based Software Bill of Materials
  • Image Signing - Cosign for cryptographic signatures
  • Secrets Management - External Secrets Operator + HashiCorp Vault
  • Zero Trust Architecture - Security-first architecture

Learn more about the Security Plane β†’

Learning & Growth

  • Dojo Learning Environment - Hands-on labs with auto-validation
  • Progress Tracking - Visual dashboards of learning journey
  • Community Support - Dedicated channels per belt level
  • Certification - Recognized credentials for each belt

πŸ“Š DORA Metrics: Built-In, Not Bolt-On

Fawkes automates collection and visualization of the Four Key Metrics that separate high performers from the rest:

Metric What It Measures Fawkes Automation
Deployment Frequency How often you deploy to production βœ… Automated via webhooks
Lead Time for Changes Time from commit to production βœ… Git β†’ CI β†’ CD tracking
Change Failure Rate % of deployments causing failures βœ… Deployment correlation
Time to Restore Service Time to recover from incidents βœ… Incident detection to resolution

Real-time dashboards show your team's performance and track improvement over time.

View DORA Dashboard Demo β†’


🎯 Who Is Fawkes For?

Platform Engineering Teams

Build and operate internal platforms with best practices baked in. Spend less time on toil, more on innovation.

DevOps Teams Evolving to Platform Engineering

Make the transition with a comprehensive platform that embodies modern practices.

Engineering Leaders

Improve delivery performance with data-driven insights. Achieve elite DORA metrics.

Platform Engineering Students

Learn by doing with hands-on labs on production-grade infrastructure. Earn recognized certifications.

Organizations Building IDPs

Don't start from scratch. Deploy a production-ready platform and customize to your needs.


⚑ Quick Start

Not sure where to begin? Choose the path that fits your goal:

Path Goal Time
A β€” Evaluate Locally Try Fawkes on your laptop with k3d β€” no cloud account needed ~20 min
B β€” Deploy to Cloud Production-capable deployment on AWS EKS 2–4 hours
C β€” Enterprise Multi-Cloud Multi-cloud, SSO, RBAC, compliance 1–2 days

Fastest start (Path A):

git clone https://github.com/paruff/fawkes.git
cd fawkes
make dev-up      # creates k3d cluster + deploys 5 core components
make dev-status  # prints service URLs and credentials

Full Getting Started Guide β†’


πŸ—οΈ Architecture

Fawkes is built on a modern, cloud-native architecture:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              Fawkes Product Delivery Platform                β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚                                                              β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
β”‚  β”‚       Backstage Developer Portal + Dojo Hub        β”‚    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
β”‚           β”‚                                                  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”        β”‚
β”‚  β”‚  Collaboration   β”‚   Project    β”‚    Dojo     β”‚        β”‚
β”‚  β”‚  (Mattermost)    β”‚ (Focalboard) β”‚  Learning   β”‚        β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜        β”‚
β”‚           β”‚                                                  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”        β”‚
β”‚  β”‚   CI/CD β€’ GitOps β€’ Observability β€’ Security   β”‚        β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜        β”‚
β”‚           β”‚                                                  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”        β”‚
β”‚  β”‚  Kubernetes + Multi-Cloud Infrastructure      β”‚        β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Key Components:

  • Backstage - Developer portal and dojo learning hub
  • Mattermost - Team collaboration and ChatOps
  • Focalboard - Project management (bundled with Mattermost)
  • Jenkins - CI/CD pipelines with golden paths
  • ArgoCD - GitOps-driven continuous delivery
  • Prometheus & Grafana - Metrics and dashboards
  • OpenSearch - Log aggregation and search
  • SonarQube & Trivy - Security scanning
  • Dojo Environment - Isolated learning labs

View Full Architecture β†’


πŸŽ“ Learning Paths

Path 1: I Want to Learn Platform Engineering

Start Here: Dojo White Belt

  1. Enroll in White Belt (8 hours)
  2. Complete 4 modules with hands-on labs
  3. Pass assessment and earn certification
  4. Progress through Yellow, Green, Brown, Black belts
  5. Total time: 40 hours to platform architect

Skills You'll Gain:

  • Deploy applications with CI/CD
  • Implement GitOps workflows
  • Configure observability stacks
  • Respond to incidents effectively
  • Design platform architectures

Path 2: I Want to Deploy Fawkes

Start Here: Deployment Guide

  1. Review prerequisites and architecture
  2. Provision cloud infrastructure (30 min)
  3. Deploy platform components (30 min)
  4. Configure integrations (30 min)
  5. Onboard first team (1 hour)

What You'll Have:

  • Production-ready IDP
  • Automated DORA metrics
  • Golden path templates
  • Team collaboration platform
  • Learning environment for your teams

Path 3: I Want to Contribute

Start Here: Contributing Guide

  1. Join the conversation in GitHub Discussions
  2. Review open issues and good first issues
  3. Pick something that interests you
  4. Submit your first PR
  5. Celebrate with the community! πŸŽ‰

Ways to Contribute:

  • Code (platform features, dojo modules)
  • Documentation (guides, tutorials)
  • Dojo content (create new modules)
  • Community support (help others in Discussions)
  • Bug reports and feature requests

πŸ“š Documentation

Comprehensive documentation for all aspects of Fawkes:

Getting Started

Dojo Learning

Platform Components

Operations

Contributing


🌟 Key Features

For Platform Teams

βœ… Production-Ready - Battle-tested components, enterprise-grade reliability βœ… Open Source - No vendor lock-in, full control, MIT licensed βœ… Multi-Cloud - AWS, Azure, GCP with consistent APIs βœ… GitOps Native - Declarative configuration, automated reconciliation βœ… Extensible - Plugin architecture, REST APIs, customizable βœ… Well Documented - Comprehensive guides, tutorials, runbooks

For Development Teams

βœ… Self-Service - Deploy without tickets, provision infrastructure instantly βœ… Golden Paths - Pre-configured templates for common scenarios βœ… Fast Feedback - Build, test, deploy in minutes βœ… Visibility - Real-time status, metrics, logs, traces in one place βœ… ChatOps - Manage deployments from team chat βœ… Safety - Automated testing, security scanning, easy rollback

For Engineering Leaders

βœ… DORA Metrics - Measure and improve delivery performance βœ… Cost Visibility - Track infrastructure and operational costs βœ… Compliance - Automated policy enforcement, audit trails βœ… Team Health - Developer satisfaction tracking (NPS) βœ… Skill Development - Integrated learning with certification βœ… ROI Tracking - Quantify platform value and improvements


πŸ”Œ Extensions

Advanced capabilities available as opt-in add-ons. Extensions are not deployed by default β€” they add operational complexity and resource requirements beyond the core platform.

Extension Components When to Add
AI Weaviate (vector DB), RAG service for semantic search LLM tooling, semantic doc search
Data Platform DataHub (data catalog), Great Expectations (quality) Data catalog, lineage tracking, quality validation

View all extensions β†’


🀝 Community

Community is forming. Join the conversation in GitHub Discussions. Office hours and chat channels will be announced once the platform reaches beta.

Get Involved


πŸ—ΊοΈ Roadmap

Current Release: v0.3.0 (December 2025)

  • βœ… Core architecture and governance
  • βœ… Dojo learning system design
  • βœ… User research infrastructure β€” personas, interview guides, insights database
  • βœ… Product discovery and adoption support
  • βœ… Security plane β€” SBOM, image signing, policy enforcement
  • βœ… DORA metrics automation and dashboards
  • βœ… Multi-cloud support (AWS, Azure, GCP)
  • βœ… GitOps workflows with ArgoCD
  • βœ… Observability stack (Prometheus, Grafana, OpenTelemetry)
  • βœ… Jenkins CI/CD with golden path templates
  • βœ… Backstage developer portal
  • βœ… Mattermost collaboration platform
  • βœ… Extensions β€” AI (Weaviate, RAG service) and Data Platform (DataHub) available as opt-in add-ons

Q1 2026: Platform Expansion

  • Multi-cloud support (Azure, GCP)
  • Complete belt curricula (all 5 belts)
  • Advanced security features
  • Enterprise features (SSO, RBAC)
  • 50+ production deployments target

Q2 2026: Ecosystem & Scale

  • Backstage plugin marketplace
  • Community-contributed dojo modules
  • Advanced DORA analytics
  • Cost optimization features
  • 100+ certified platform engineers

Q3 2026: Enterprise & Certification

  • CNCF Sandbox application
  • Platform Engineering University partnership launch
  • Enterprise support offerings
  • Multi-region deployments
  • Chaos engineering integration

Q4 2026: Innovation

  • AI-powered platform insights
  • Predictive failure detection
  • Automated performance optimization
  • FinOps integration
  • 1,000+ community members

View Detailed Roadmap β†’


🀝 Contributing

Fawkes is open source and community-driven. We welcome contributions of all kinds:

Ways to Contribute

πŸ› Report Bugs - Open an issue

✨ Request Features - Share your ideas

πŸ“ Improve Documentation - Help others learn and succeed

πŸ’» Submit Code - Fix bugs, add features, optimize performance

πŸŽ“ Create Dojo Content - Develop new learning modules

🎨 Design & UX - Improve interfaces and user experience

πŸ’¬ Support Community - Answer questions, help others

🌍 Translate - Help make Fawkes accessible globally

Getting Started with Contributing

  1. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md

  2. Join the GitHub Discussions

  3. Browse good first issues

  4. Fork the repository and create a branch

  5. Set up code quality tools - Essential for all contributors:

    # Install pre-commit hooks (one-time setup)
    make pre-commit-setup
    
    # Run linters before committing
    make lint
  6. Make your changes with tests and documentation

  7. Submit a pull request

  8. Celebrate your contribution! πŸŽ‰

Code Quality Standards

All contributions must pass:

  • βœ… Automated linting - Bash, Python, Go, YAML, JSON, Markdown, Terraform
  • βœ… Security scanning - Secrets detection, SAST, container scanning
  • βœ… Pre-commit hooks - Run automatically on git commit
  • βœ… CI/CD checks - GitHub Actions validate on every PR

πŸ“– See: CODING_STANDARDS.md - Comprehensive coding standards guide with examples and FAQs

Recognition

All contributors are recognized in:

  • CONTRIBUTORS.md (automated via all-contributors bot)
  • Monthly "Contributor of the Month" spotlight
  • Annual "Top Contributors" feature
  • Speaking opportunities at community events

πŸ“œ License

Fawkes is open source software licensed under the MIT License.

This means you can:

  • βœ… Use commercially
  • βœ… Modify
  • βœ… Distribute
  • βœ… Sublicense
  • βœ… Use privately

With the requirements to:

  • Include the license and copyright notice
  • State changes made to the code

No Warranty - Software is provided "as is" without warranty.


πŸ™ Acknowledgments

Fawkes is built on the shoulders of giants and inspired by:

  • Accelerate by Nicole Forsgren, Jez Humble, Gene Kim - DORA research foundation
  • Team Topologies by Matthew Skelton, Manuel Pais - Platform team patterns
  • Backstage by Spotify - Developer portal inspiration
  • Platform Engineering community - Best practices and patterns
  • CNCF Projects - Kubernetes, Prometheus, ArgoCD, and hundreds of other tools

Special Thanks


πŸ“ž Support & Contact

Community Support (Free)

  • GitHub Discussions - Questions and discussions
  • GitHub Issues - Bug reports and feature requests
  • Documentation - Comprehensive guides and tutorials

Professional Support

Roadmap item β€” not yet available. Professional support (implementation assistance, training, SLA) is planned as a future offering. Follow GitHub Discussions for announcements.


πŸš€ Start Your Journey

Choose your path:

πŸŽ“ Learn Platform Engineering

Enroll in Dojo White Belt β†’

Start your journey from novice to platform architect. 8 hours to your first certification.

πŸ—οΈ Deploy Fawkes Platform

Follow Quick Start Guide β†’

Get your platform running in 30 minutes. Production-ready in hours, not months.

🀝 Join the Community

Join GitHub Discussions β†’

Connect with platform engineers, ask questions, and share your experiences.

πŸ’» Contribute to Fawkes

View Good First Issues β†’

Make your first contribution and become part of the community.


Built with ❀️ by platform engineers, for platform engineers

Dojo β€’ Quick Start β€’ Docs β€’ Community β€’ Contributing β€’ License

Fawkes: Named after Dumbledore's phoenix, symbolizing resilience and renewal

πŸ›‘ License

This project is licensed under the MIT License.

uFawkes Stack Ecosystem

Fawkes is the core platform. The uFawkes stacks are composable components that extend the platform:

Stack Description Link
uFawkesObs Observability β€” Prometheus, Grafana, AI dashboards GitHub
uFawkesPipe CI/CD β€” Jenkins, Buildpacks, DevSecOps GitHub
uFawkesDORA DORA metrics β€” dashboards, VSM, delivery performance GitHub
uFawkesSec Security β€” policy-as-code, supply chain, guardrails GitHub
uFawkesDevX Developer experience β€” golden paths, IDP templates GitHub
uFawkesAI AI agent templates β€” golden path scaffolding GitHub

Marketing Site: ufawkes.dev Product Suite Roadmap: ROADMAP.md

About

Modular GitOps IDP with CI/CD, observability, and multi-cloud provisioning. Built for contributors.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages