# projen/projen

Rapidly build modern applications with advanced configuration management

Repository: https://github.com/projen/projen
Canonical: https://ross.abutalabs.com/products/projen
Homepage: https://projen.io
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: cdk, constructs, aws-cdk, repository-management, repository-tools, typescript, generator, scaffolding, templates, jsii, hacktoberfest
Last push: 2026-08-26T21:21:35+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 2305, "days_push": 7, "days_rel": 7, "gap_med": 1.0, "n_releases_24m": 263}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2948, forks 413 (observed 2026-08-28T04:07:31.872376+00:00)

## What it is
projen is a CLI tool and library that synthesizes project configuration files (package.json, tsconfig.json, GitHub Workflows, linting, CI/CD) from strongly-typed definitions written in jsii-compatible languages like TypeScript, Python, Java, and Go. Unlike one-off scaffolding generators, it continuously manages configuration through code, enabling consistent updates across many repositories.

## Use cases
- scaffold a new typescript project with eslint jest and github actions
- manage package.json and tsconfig through code instead of manual edits
- keep CI/CD workflows consistent across dozens of repositories
- bootstrap an aws cdk app in typescript python or java
- automate dependency upgrades and changelog-based releases
- define custom reusable project templates for an organization

## When to choose
- you maintain many repositories that need uniform configuration and CI/CD
- you want configuration managed as code with strong typing and no manual file edits
- you build AWS CDK, CDK8s, or CDKTF projects and want batteries-included setup
- you want automated releases, changelogs, and dependency upgrades out of the box

## When to avoid
- you prefer hand-editing config files or use tools that fight generated files
- you need a one-off template generator with full ownership of output files
- your project uses languages or tooling not covered by projen's project types
- your team is unwilling to learn projen's API for routine config changes

## Facets
- artifact type: cli-tool
- maturity: active
- function: build-tool, configuration-management, developer-tools, ci-cd
- domain: developer-tools, infrastructure-as-code
- platform: cli, cross-platform
- tags: project-scaffolding, config-as-code, monorepo-tooling, jsii, aws-cdk, repository-management, code-generation, scaffolding, automation, devops, nodejs

## Member repositories
- projen/projen (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:31.872376+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:32:45.059218+00:00, confidence not recorded.
  - readme: https://github.com/projen/projen (fetched 2026-08-28T04:07:31.872376+00:00, sha a6c2d5cad9b2)
  - homepage: https://projen.io (fetched 2026-08-29T09:48:21.445868+00:00, sha 8ba1c1579343)
  - site_page: https://projen.io/docs/introduction (fetched 2026-08-29T09:48:21.455014+00:00, sha 4c2dcda3cf3f)
  - site_page: https://projen.io/docs/api/projen (fetched 2026-08-29T09:48:21.457451+00:00, sha 34af7e43b69d)
  - site_page: https://projen.io/docs/introduction/getting-started (fetched 2026-08-29T09:48:21.461247+00:00, sha 3d4e2d4205c6)
- Data as of 2026-08-30T08:39:29.467469+00:00.
