{"id":34726825,"url":"https://github.com/victorandcode/tblue","last_synced_at":"2026-05-26T10:33:11.513Z","repository":{"id":44160227,"uuid":"164727626","full_name":"victorandcode/tblue","owner":"victorandcode","description":"📘 Trello blueprints, scaffolding for trello boards (a.k.a. yeoman for trello)","archived":false,"fork":false,"pushed_at":"2022-12-06T14:55:05.000Z","size":7238,"stargazers_count":4,"open_issues_count":17,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-03-21T04:25:37.317Z","etag":null,"topics":["cli","javascript","scaffolding","trello"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/victorandcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-08T20:30:11.000Z","updated_at":"2023-03-09T03:49:19.000Z","dependencies_parsed_at":"2023-01-23T10:30:15.568Z","dependency_job_id":null,"html_url":"https://github.com/victorandcode/tblue","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/victorandcode/tblue","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorandcode%2Ftblue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorandcode%2Ftblue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorandcode%2Ftblue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorandcode%2Ftblue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/victorandcode","download_url":"https://codeload.github.com/victorandcode/tblue/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorandcode%2Ftblue/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33517112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T03:12:49.672Z","status":"ssl_error","status_checked_at":"2026-05-26T03:12:47.976Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cli","javascript","scaffolding","trello"],"created_at":"2025-12-25T02:30:40.347Z","updated_at":"2026-05-26T10:33:11.508Z","avatar_url":"https://github.com/victorandcode.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003etblue 📘\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n[![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Trello%20Scaffolding%20CLI%20tool!%20Tblue\u0026url=https://github.com/victor-cordova/tblue\u0026hashtags=trello,scaffolding,yeoman,templates,developers,github)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n![version](https://img.shields.io/badge/version-0.2.0-blue.svg?maxAge=2592000)\n[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/dwyl/esta/issues)\n\n\u003ch4 align=\"center\"\u003eTrello blueprints, scaffolding for trello boards (a.k.a. yeoman for trello)\u003c/h4\u003e\n\n![Demo](https://raw.githubusercontent.com/victorandcode/tblue/master/docs/images/demo.gif)\n\n**Result**:\n![Sample generated board](https://raw.githubusercontent.com/victorandcode/tblue/master/docs/images/sample_generated_board.png)\n\n## 💡 Motivation\nIf you use trello a lot, it's likely that you have common tasks based on past experience and also custom cards for a given project. Wouldn't it be nice to have some sort of blueprint or template we could use to bootstrap our boards? This project aims to solve this need.\n\n## 🔧 Prerequisites\nThis project requires 2 environment variables set. Please add them to your .bash_profile or wherever they are needed for your environment. Next you'll find which variables you need to set and what value you should use for each one.\n\n(You can optionally just run `tblue` and the cli will guide you 😉)\n\n### TRELLO_API_KEY\nLog into trello and copy the developer key from https://trello.com/app-key. Use that value for this environment variable.\n![Api Key](https://raw.githubusercontent.com/victorandcode/tblue/master/docs/images/api_key.png)\n\n### APP_TOKEN\nUse your api key from last step and replace **API_KEY** inside the next url https://trello.com/1/authorize?key=API_KEY\u0026name=tblueScaffoldingForTrello\u0026expiration=never\u0026response_type=token\u0026scope=read,write\n\nNow copy/paste the full url into your browser\n\n![Api Key](https://raw.githubusercontent.com/victorandcode/tblue/master/docs/images/app_token.png)\n\nGrant access to the script so you get a token, \u003cspan style=\"color:red\"\u003eonly you know what this token is so only your local instance of `tblue` \nwill use it.\u003c/span\u003e\n\n![Api Key](https://raw.githubusercontent.com/victorandcode/tblue/master/docs/images/app_token2.png)\n\nNow place the token as the value for this environment variable.\n\n## 🏃 How to run\n```sh\nnpm install -g tblue\ntblue\n```\n\n## 📜 Workflow\n1. Choose a name for your board\n2. Choose which blueprint you want to use\n3. Start answering Y/n for each question in the blueprint\n4. Start adding specific \"features\" for your project\n5. Open your new board from the terminal 👶\n\n## CLI options\n\n|Command option| Description|\n|---------------|-----------|\n|`-h` or `--help`|Shows all available command line options|\n|`-c` or `--custom-blueprints-folder`| Allows passing a folder containing one or multiple blueprints ([see Custom blueprints](#custom-blueprints)). Only the files immediately inside the folder that have a `.blueprint.json` extension and have a valid template will be evaluated|\n\n## Custom blueprints\nThe custom blueprints you create must have the following format. **If they don't, they will not show up in the blueprints selection screen**.\n```js\n{\n    //Name that will be prompted in the CLI\n    \"name\": \"Simple API\",\n\n    //The name you give to features for your particular blueprint. e.g. feature, endpoint, article, etc\n    \"unitOfWork\": \"feature\",\n\n    //Questions that could generate a card according to your project's need\n    \"questions\": [\n        {\n            \"content\": \"Will you be using Docker?\",\n            \"cardToGenerate\": {\n                \"name\": \"Create Docker configuration\"\n            }\n        },\n    ],\n\n    //These are cards that will always be generated when you use this blueprint\n    \"cards\": [{\"name\": \"Repository configuration\"}]\n}\n```\n**Note: If you want store your custom blueprints without having to pass alwas the `-c` flag. You can store them in the `~/.blueprints` folder**\n\n## Running locally\n```sh\nnpm install\nnpm start\n```\n\n## Run tests\n```sh\nnpm test\n```\n\n## [Contributing](./CONTRIBUTING.md)\n\n## Compatibilty\nEmojis don't show correctly in windows' cmd 💔\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorandcode%2Ftblue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictorandcode%2Ftblue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorandcode%2Ftblue/lists"}