This repository contains the source for SecureByDesignHandbook.com, an authoritative, vendor-neutral reference for building secure connected devices. It translates complex regulatory requirements (like the EU's Cyber-Resilience Act) into concrete engineering practices for product security teams.
This website is built using Docusaurus, a modern static website generator.
- Purpose & Positioning Statement - Mission, audience, and strategic vision
- Navigation Structure - Proposed site structure and user journeys (draft)
- Content & Brand Style Guide - Editorial standards and guidelines for contributors
npm installnpm startThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
npm run buildThis command generates static content into the build directory and can be served using any static contents hosting service.
The site is automatically deployed to GitHub Pages using GitHub Actions.
- Live Site: https://securebydesignhandbook.com
- Trigger: Any push to the
mainbranch automatically triggers deployment - Workflow: See
.github/workflows/deploy.ymlfor the deployment configuration - Process: Build → Deploy to GitHub Pages → Live in ~2-3 minutes
We welcome contributions from security practitioners, compliance experts, and engineers building connected devices!
- 📋 How to contribute: See our Contributing Guide
- 💡 Suggest improvements: Open an Issue
- 💬 Ask questions: Start a Discussion
Whether you want to add implementation guides, fix typos, or suggest new topics, your contributions help make connected devices more secure.