{"id":23413574,"url":"https://github.com/zumerlab/zumerbox","last_synced_at":"2025-10-13T01:03:02.412Z","repository":{"id":227863115,"uuid":"772571577","full_name":"zumerlab/zumerbox","owner":"zumerlab","description":"Ready-to-use small set of development tools","archived":false,"fork":false,"pushed_at":"2024-04-05T18:48:05.000Z","size":125,"stargazers_count":21,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-13T01:02:57.535Z","etag":null,"topics":["developer-tools","devtools","git","no-config","npm","personal-project","ready-to-use","side-project","small-projects"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zumerlab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2024-03-15T13:09:08.000Z","updated_at":"2025-09-28T22:06:24.000Z","dependencies_parsed_at":"2024-03-25T16:54:15.592Z","dependency_job_id":"24f10988-6c65-4eea-94c1-c158b4aad5ba","html_url":"https://github.com/zumerlab/zumerbox","commit_stats":null,"previous_names":["zumerlab/tinybox","zumerlab/zumerbox"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/zumerlab/zumerbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zumerlab%2Fzumerbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zumerlab%2Fzumerbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zumerlab%2Fzumerbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zumerlab%2Fzumerbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zumerlab","download_url":"https://codeload.github.com/zumerlab/zumerbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zumerlab%2Fzumerbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279013887,"owners_count":26085325,"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","status":"online","status_checked_at":"2025-10-12T02:00:06.719Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["developer-tools","devtools","git","no-config","npm","personal-project","ready-to-use","side-project","small-projects"],"created_at":"2024-12-22T19:38:16.489Z","updated_at":"2025-10-13T01:03:02.396Z","avatar_url":"https://github.com/zumerlab.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZumerBox\n\nZumerBox is a small set of development tools designed to run common tasks in software development workflows. It offers functionalities for linting, formatting, building, testing, and releasing projects.\n\n## Target audience\n\nZumerBox is intended for small projects with single or small development teams. It was initially created for personal use but can be useful for sharing with other developers who want to quickly test concepts or iterate on small projects.\n\n## No configuration needed\n\nThe idea behind ZumerBox is that it can be used out-of-the-box without any configuration. Each tool is designed to work with sensible defaults, allowing you to get started quickly without having to spend time configuring settings.\n\n## No installation needed\n\nYou can use the ZumerBox bundle or any of its tools without installation by running `npx`. See [Usage](#usage) for details.\n\n## Design philosophy\n\nZumerBox tools are designed as wrappers for popular tools such as Jest, ESLint, StyleLint, ESbuild, Prettier, and update-changelog. They are pre-configured to be immediately usable without the need for extensive setup or configuration.\n\n## Installation\n\nYou can install ZumerBox as a bundle or each tool individually according to your preference.\n\n### Bundle installation\n\nTo install the entire ZumerBox bundle, simply run:\n\n```bash\nnpm install zumerbox --save-dev\n```\n\nThis will install all tools included in ZumerBox.\n\n### Individual tool installation\n\nAlternatively, you can install each tool independently. Here are the available tools:\n\n- @zumerbox/doc-extractor: [npm 📦](https://www.npmjs.com/package/@zumerbox/doc-extractor) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-doc-extractor)\n- @zumerbox/doc-extractor: [npm 📦](https://www.npmjs.com/package/@zumerbox/doc-extractor) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-doc-extractor)\n- @zumerbox/bump: [npm 📦](https://www.npmjs.com/package/@zumerbox/bump) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-bump)\n- @zumerbox/build: [npm 📦](https://www.npmjs.com/package/@zumerbox/build) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-build)\n- @zumerbox/code-format: [npm 📦](https://www.npmjs.com/package/@zumerbox/code-format) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-code-format)\n- @zumerbox/css-lint: [npm 📦](https://www.npmjs.com/package/@zumerbox/css-lint) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-css-lint)\n- @zumerbox/scss-lint: [npm 📦](https://www.npmjs.com/package/@zumerbox/scss-lint) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-scss-lint)\n- @zumerbox/js-lint: [npm 📦](https://www.npmjs.com/package/@zumerbox/js-lint) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-js-lint)\n- @zumerbox/tests: [npm 📦](https://www.npmjs.com/package/@zumerbox/tests) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-tests)\n- @zumerbox/npm-init: [npm 📦](https://www.npmjs.com/package/@zumerbox/npm-init) | [GitHub :octocat:](https://github.com/zumerlab/zumerbox-npm-init)\n\nYou can install any of these tools individually using npm:\n\n```bash\nnpm install @zumerbox/tool-name --save-dev\n```\n\nReplace `tool-name` with the name of the tool you want to install.\n\n## Usage\n\nYou can use any tool from ZumerBox without the need for installation by running it directly with `npx`. This allows for a hassle-free setup and usage. For example, to run the tests, you can use in the project root folder:\n\n```bash\n# using ZumerBox bundle\nnpx zumerbox tests\n```\n\nor\n\n```bash\n# using ZumerBox individual tool\nnpx @zumerbox/tests\n```\n\nReplace `tests` with the name of the tool you want to use.\n\nAlternatively, you can integrate ZumerBox tools into your npm package scripts. For instance, you can add a script entry in your `package.json` file:\n\n```json\n{\n  \"scripts\": {\n    \"bump\": \"npx zumerbox bump\"\n  }\n}\n```\n\nor with an individual tool:\n\n```json\n{\n  \"scripts\": {\n    \"bump\": \"npx @zumerbox/bump\"\n  }\n}\n```\n\nThis way, you can utilize ZumerBox seamlessly within your project's development workflow.\n\n## Recipes\n\n### Recipe 1: Enhancing development workflow with `package.json` scripts\n\n#### Ingredients:\n\n- Zumerbox installed in your project\n- `package.json` file\n\n#### Instructions:\n\n1. **Installation**: Install Zumerbox and its tools in your project.\n\n   ```bash\n   npm install zumerbox --save-dev\n   ```\n\n2. **Configuration**: Add scripts to your `package.json` file to automate common development tasks using Zumerbox tools. You can enhance your workflow by incorporating scripts for versioning, testing, linting, updating changelog, and more.\n\n   Example `package.json` scripts including all tasks:\n\n   ```json\n   {\n     \"scripts\": {\n       \"lint:css\": \"npx zumerbox css-lint --write\",\n       \"lint:js\": \"npx zumerbox js-lint --fix\",\n       \"format:code\": \"npx zumerbox code-format\",\n       \"tests\": \"npx zumerbox tests\",\n       \"prebump\": \"npm run lint:css  \u0026\u0026 npm run lint:js \u0026\u0026 npm run format:code \u0026\u0026 npm run tests\",\n       \"bump\": \"npx zumerbox bump \u0026\u0026 npx zumerbox changelog\",\n       \"build\": \"npx zumerbox build\",\n       \"git:push\": \"git commit -am\\\"chore: bump version\\\" \u0026\u0026 git push --follow-tags\",\n       \"npm:publish\": \"npm publish\",\n       \"workflow\": \"npm run bump \u0026\u0026 npm run build \u0026\u0026 npm run git:push \u0026\u0026 npm run npm:push\"\n     }\n   }\n   ```\n\n   Example `package.json` scripts including some tasks:\n\n   ```json\n   {\n     \"scripts\": {\n       \"prebump\": \"npx zumerbox tests\",\n       \"bump\": \"npx zumerbox bump \u0026\u0026 npx zumerbox changelog  \u0026\u0026 git commit -am\\\"chore: bump version\\\"\"\n     }\n   }\n   ```\n\n3. **Usage**:\n\n- **Workflow**: In first example run this command to automatically lint, format, test, bump version, build dist files, push to git and publish on npm.\n\n  ```bash\n  npm run workflow\n  ```\n\n- **Bump**: In second example run this command to test, bump a version and update changelog.\n\n#### Notes:\n\n- If you want, the installation part can be ommited since zumerbox bundle or any of its tools are executables via `npx`.\n\n- The `prebump` script is executed automatically before `bump` to ensure code quality by running linting tasks. This is done directly by npm scripts that support pre and post commands [(Learn more on NPM)](https://docs.npmjs.com/cli/v10/using-npm/scripts).\n\n- If there is an error in any tasks the flow will be interrupted. For instance, if tests don't pass, process exit.\n\nBy following this recipe, you can create a comprehensive development workflow that automates various tasks using Zumerbox and ensures code quality and consistency throughout the development process. Adapt this receipt to your needs.\n\n### Recipe 2: Check if project name is valid and available on `npm register`\n\n#### Ingredients:\n\n- Zumerbox bundle or @zumerbox/npm-init\n- `package.json` file (optional)\n\n#### Instructions:\n\n1. **Create a folder project**:\n\n   ```bash\n       mkdir \u003c folder project \u003e\n       cd \u003c folder project \u003e\n   ```\n\n2. **Run npm-init tool**:\n\n   ```bash\n       npx @zumerbox/npm-init\n   ```\n\n   Or\n\n   ```bash\n       npx zumerbox npm-init\n   ```\n\n3. **Usage**: Just follow tool prompts. `npm-init` will ask to choose a package name and will check if this name is valid and available. It is allowed to to choose just a name or a scoped name (ej: @organization/name). By default `npm-init` will add an author name based on git config, and a MIT licence.\n\n#### Notes:\n\n- If you already have an initialized project with a `package.json`, `npm-nit` will update this file keeping your previous configuration.\n\n- Since this tool is used occasionally, We not recommended to install it in your project as a dependency.\n\n## License\n\nZumerBox is licensed under the [MIT License](LICENSE).\n\n## Bugs and issues\n\nIf you encounter any bugs or have suggestions for improvements, please feel free to open an issue on [GitHub](https://github.com/zumerlab/zumerbox/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzumerlab%2Fzumerbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzumerlab%2Fzumerbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzumerlab%2Fzumerbox/lists"}