Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Codeward Registry

The central repository for Codeward profiles — modular, reusable policy configurations for the Codeward scanner.

Instead of writing policies from scratch, browse profiles that match your stack and security posture, copy them into your project, and customize as needed.

What is a Profile?

A profile is a named, versioned, self-contained policy configuration for a real-world use case. It defines:

  • What to scan for — severity thresholds, license types, package names, file structures, PR metadata, and more
  • What action to take — block, warn, or inform
  • Where to report — PR comments, GitHub issues, webhooks, or files
  • Why it exists — documentation, rationale, and example inputs/outputs

Each profile is a complete, working .codeward.json (or .codeward.yaml) that you can drop into your repository and use immediately.

Quick Start

# 1. Browse profiles and pick one that fits your stack
# 2. Copy the config into your repo
# 3. Run the scanner

GitHub Action

# .github/workflows/codeward.yml
name: Codeward
on: pull_request
jobs:
  scan:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: read
      pull-requests: write
    steps:
      - uses: codeward-io/[email protected]

Standalone Binary

Pre-built binaries are available for Linux, macOS, and Windows — no Docker required:

# Download (replace OS/arch as needed: linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, windows-amd64, windows-arm64)
curl -L -o codeward-scan \
  https://github.com/codeward-io/scan/releases/download/v0.4.0/codeward-scan-linux-amd64
chmod +x codeward-scan

# Run with a profile from the registry
./codeward-scan --config .codeward.yaml

Docker

docker run --rm \
  -v /path/to/your/repo:/main:rw \
  ghcr.io/codeward-io/scan:v0.4.0

Available Profiles

Official

Maintained by the Codeward team.

🔒 Security

Profile Description
ai-governance Detect AI/ML frameworks, API key leaks, model files, and enforce governance
api-security Detect common API security anti-patterns in JavaScript/TypeScript code
cicd-security Validate GitHub Actions workflows for security best practices
database-security Detect SQL injection, hardcoded DB credentials, and insecure connections
env-management Detect .env secrets, hardcoded URLs, and missing .env.example
owasp-security-misconfig OWASP A05 security misconfiguration detection
owasp-supply-chain Detect supply chain attack patterns across multiple ecosystems
security-essentials Block new critical/high CVEs, warn on medium, track existing and unfixable

🏗️ Infrastructure

Profile Description
infra-compose Detect Docker Compose security and reliability issues
infra-docker Dockerfile security, image pinning, non-root user, and best practices
infra-helm Detect Helm chart security and configuration issues
infra-kubernetes Kubernetes security, reliability, and governance best practices
terraform-security Terraform security misconfigurations, encryption, IAM, and version pinning

💻 Language

Profile Description
frontend-essentials Frontend lockfile, standard scripts, and no debug logging
lang-dotnet Target framework, nullable types, Console.WriteLine, Thread.Sleep, Process.Start detection
lang-go Go version, module hygiene, code quality, and deprecated API detection
lang-java Java/Kotlin build config, code quality, security, and build tool hygiene
lang-node Node.js lockfile, debug statements, deprecated libraries, eval detection, and code quality checks
lang-php PHP security scanning — injection, dangerous functions, deprecated APIs, debug statements
lang-python Python dependency pinning, security checks, debug detection, and code quality
lang-ruby Gemfile hygiene, eval/Marshal detection, binding.pry, mass assignment, command injection
lang-rust Rust code quality, safety, and project hygiene
lang-typescript Strict mode, any type, @ts-ignore, non-null assertions, type assertions

📋 Compliance & Governance

Profile Description
compliance-audit Block restricted licenses, warn on weak copyleft and unknown licenses, check LICENSE file
documentation-quality README sections, CHANGELOG, project description
git-hygiene .gitignore completeness, merge conflict markers
legal-headers Ensure source files contain Copyright/License/SPDX headers
pr-governance PR size, drafts, title format, description, sensitive files, infra changes, crypto keys, labels, reviewers, file count
testing-standards Test scripts, .only/.skip detection, focused test prevention

🔐 Secrets

Profile Description
secret-prevention Detect secrets, credentials, and sensitive files across your codebase

📁 Repository

Profile Description
repo-hygiene Repository cleanliness — junk files, binaries, merge conflicts, TODOs
repo-mandatory-files Ensure essential repository files exist and README has content
repo-structure Standard directory layout conventions (docs/, tests/, .github/)

📦 Quality

Profile Description
dependency-hygiene Detect wildcard versions, missing lockfiles, and floating dependencies
monitoring-essentials Detect console.log, missing health checks, and unstructured logging

Which Profile Should I Use?

Start here → security-essentials — every project should use this as a baseline.

Then add profiles that match your stack:

If your project has... Add this profile
AI/ML or LLM-powered projects ai-governance
REST or GraphQL API projects in JavaScript/TypeScript api-security
GitHub Actions workflows cicd-security
Commercial/proprietary licensing compliance-audit
Projects with database connections database-security
Projects with package managers (npm, bundler, go modules) dependency-hygiene
Any project documentation-quality
Projects using environment variables and .env files env-management
React/Vue/Angular frontend projects frontend-essentials
Any git repository git-hygiene
Projects using Docker Compose infra-compose
Dockerfiles infra-docker
Helm charts infra-helm
Kubernetes manifests infra-kubernetes
.NET/C# code lang-dotnet
Go code lang-go
Java/Kotlin code lang-java
Node.js backend projects lang-node
PHP code lang-php
Python code lang-python
Ruby code lang-ruby
Rust code lang-rust
TypeScript code lang-typescript
Projects requiring license headers in source files legal-headers
JavaScript/TypeScript server applications monitoring-essentials
Web applications and APIs owasp-security-misconfig
Projects with third-party dependencies owasp-supply-chain
Teams enforcing comprehensive PR standards pr-governance
Any repository to enforce basic hygiene standards repo-hygiene
Any repository (standard files) repo-mandatory-files
Projects needing consistent directory structure repo-structure
Secrets that should never be committed secret-prevention
Any project (start here) security-essentials
Terraform configurations (AWS-focused) terraform-security
Projects with test suites testing-standards

Categories

Category Description
security Vulnerability and CVE-focused
license License compliance
language Language-specific best practices
infrastructure Docker, Kubernetes, IaC
compliance Regulatory frameworks (SOC2, ISO, etc.)
repository Repo structure, hygiene, mandatory files
governance PR governance, approval workflows
secrets Secret detection and prevention

License

Apache 2.0

About

The official registry of Codeward profiles, policies, and configuration presets.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages