{"id":15823287,"url":"https://github.com/stoked-cenv/cenv-mono","last_synced_at":"2026-05-06T13:11:27.953Z","repository":{"id":177941289,"uuid":"645886811","full_name":"stoked-cenv/cenv-mono","owner":"stoked-cenv","description":"A well considered cli and node library for managing applications, infrastructure, and configuration management.","archived":false,"fork":false,"pushed_at":"2024-04-07T12:56:09.000Z","size":5605,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-10-06T08:07:22.319Z","etag":null,"topics":["appconfig","aws","cdk","cloudfront","docker","ecr","ecs","nodejs","parameterstore","typescript"],"latest_commit_sha":null,"homepage":"https://cenv.stokedconsulting.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stoked-cenv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-26T17:11:43.000Z","updated_at":"2023-07-20T21:58:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"67b38a7f-7898-4d6c-9d4e-4bab6b07e2ce","html_url":"https://github.com/stoked-cenv/cenv-mono","commit_stats":null,"previous_names":["stoked-cenv/cenv-mono"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stoked-cenv%2Fcenv-mono","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stoked-cenv%2Fcenv-mono/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stoked-cenv%2Fcenv-mono/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stoked-cenv%2Fcenv-mono/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stoked-cenv","download_url":"https://codeload.github.com/stoked-cenv/cenv-mono/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246598189,"owners_count":20802975,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appconfig","aws","cdk","cloudfront","docker","ecr","ecs","nodejs","parameterstore","typescript"],"created_at":"2024-10-05T08:07:47.016Z","updated_at":"2026-05-06T13:11:22.929Z","avatar_url":"https://github.com/stoked-cenv.png","language":"TypeScript","funding_links":["https://opencollective.com/stoked-cenv"],"categories":[],"sub_categories":[],"readme":"\n# cenv\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://cenv-mono-artifacts.s3.amazonaws.com/cenv-deploy-curb-cloud.gif\" target=\"_blank\"\u003e\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/cli/assets/cenv-deploy.png\"\u003e\n  \u003cimg width=\"800\" alt=\"STOKED\" src=\"./packages/cli/cenv-deploy.png\"\u003e\n\u003c/picture\u003e\u003c/a\u003e\n\u003c/p\u003e\n  \u003cp align=\"center\"\u003eA well considered cli and \u003ca href=\"http://nodejs.org\" target=\"_blank\"\u003eNode.js\u003c/a\u003e library for helping manage application, infrastructure, and configuration management.\u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://nodejs.org/en/download/\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/node-18.16.1-gree\" alt=\"node.js version\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://pnpm.io/installation\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/pnpm-8.6.7-orange\" alt=\"pnpm version\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.typescriptlang.org/\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/typescript-4.9.5-blue\" alt=\"typescript version Version\" /\u003e\u003c/a\u003e \n    \u003ca href=\"https://aws.amazon.com/cdk/\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/cdk-2.85.0-232f3e\" alt=\"cdk version\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n  \u003c!--[![Backers on Open Collective](https://opencollective.com/stoked-cenv/backers/badge.svg)](https://opencollective.com/stoked-cenv#backer)\n  [![Sponsors on Open Collective](https://opencollective.com/stoked-cenv/sponsors/badge.svg)](https://opencollective.com/stoked-cenv#sponsor)--\u003e\n\n##  overview\n\n\u003cstrong\u003ecenv\u003c/strong\u003e inspects your packages and looks for specific conventions to identify `cenv modules` within each package. There are currently 5 different types of cenv modules, LIB, EXEC, PARAMS, DOCKER, and STACK. A package must have at least one cenv module in order to take advantage of the cenv tool.\n\nThe PARAMS module leverages AWS AppConfig and AWS Parameter Store to manage application parameter configuration. The DOCKER module provides a mechanism to create an AWS ECR repository for the package containers and build and push the packages containers to the repo. Finally, the STACK module uses AWS Cdk to deploy cloudformation stacks representing the infrastructure and applications contained in the packages.\n\n\n### pre-requisites\n\n- [node](https://nodejs.org/en/download/)\n- [python](https://www.python.org/downloads/)\n- [Yarn](https://classic.yarnpkg.com/en/docs/install/#debian-stable)\n- [aws cdk](https://aws.amazon.com/cdk/) \n- [docker](https://www.docker.com/products/docker-desktop)\n\n## Getting Started\n\ninstall the cli:\n\n```shell\n#npm\nnpm i -g @stoked-cenv/cli \n```\nor\n\n```shell\n#yarn\nyarn global add @stoked-cenv/cli \n```\n\n### configuring aws\n\n```shell\n cenv configure\n ```\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://cenv-mono-artifacts.s3.amazonaws.com/cenv+config.gif\" \u003e\n  \u003cimg width=\"300\" alt=\"STOKED\" src=\"https://cenv-mono-artifacts.s3.amazonaws.com/cenv+config.gif\"\u003e\n\u003c/picture\u003e\n\n```shell\n# aws profile used to access the aws account you are deploying to.. if one doesn't already exist run \"aws configure\" first\nAWS_PROFILE: (stoked)\n\n# environment region\nAWS_REGION: (us-east-1)\n\n# environment name\nENV: (dev)\n\n# everything will point to subdomains below this by default\nROOT_DOMAIN: (stokedconsulting.com)\n```\n\n##### full stack example project coming soon!\n\n### cenv-mono contents: the packages\n\nThis monorepo contains 3 packages which will be explained here. The packages are cli, lib, params, and ui.\n\nThe cli package contains the code for the end user command line interface tool.\n\nThe lib package contains the library code that can be consumed by external libraries to manage cenv parameters in their application stacks.\n\nThe ui package contains the ui code for the cli built on https://github.com/chjj/blessed.\n\n### support\n\nCall your congressperson. When that doesn't work contact [Brian Stoker](mailto:b@stokedconsulting.com).\n\n### license\n\n[MIT Licensed](https://opensource.org/license/mit/)\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"http://stokedconsulting.com/\" target=\"blank\"\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://stokedconsulting.com/img/stoked-logo.svg\"\u003e\n  \u003cimg width=\"200px\" alt=\"STOKED\" src=\"https://stokedconsulting.com/img/stoked-logo-white-no-stroke.svg\"\u003e\n\u003c/picture\u003e\n\n\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstoked-cenv%2Fcenv-mono","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstoked-cenv%2Fcenv-mono","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstoked-cenv%2Fcenv-mono/lists"}