{"id":22377105,"url":"https://github.com/micro-os-plus/sifive-templates-xpack","last_synced_at":"2026-01-06T13:38:42.783Z","repository":{"id":57160181,"uuid":"102970632","full_name":"micro-os-plus/sifive-templates-xpack","owner":"micro-os-plus","description":"An xPack with templates to generate SiFive Core Complex projects","archived":false,"fork":false,"pushed_at":"2022-05-09T18:38:34.000Z","size":410,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"xpack","last_synced_at":"2025-03-01T06:03:41.974Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Liquid","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/micro-os-plus.png","metadata":{"files":{"readme":"README-MAINTAINER.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}},"created_at":"2017-09-09T16:55:02.000Z","updated_at":"2022-05-09T18:38:28.000Z","dependencies_parsed_at":"2022-09-09T10:20:12.554Z","dependency_job_id":null,"html_url":"https://github.com/micro-os-plus/sifive-templates-xpack","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fsifive-templates-xpack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fsifive-templates-xpack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fsifive-templates-xpack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-os-plus%2Fsifive-templates-xpack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/micro-os-plus","download_url":"https://codeload.github.com/micro-os-plus/sifive-templates-xpack/tar.gz/refs/heads/xpack","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245708992,"owners_count":20659626,"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":[],"created_at":"2024-12-04T22:12:48.613Z","updated_at":"2026-01-06T13:38:42.746Z","avatar_url":"https://github.com/micro-os-plus.png","language":"Liquid","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![license](https://img.shields.io/github/license/sifive/templates-xpack)](https://github.com/sifive/templates-xpack/blob/xpack/LICENSE)\n[![CI on Push](https://github.com/sifive/templates-xpack/actions/workflows/CI.yml/badge.svg)](https://github.com/sifive/templates-xpack/actions/workflows/CI.yml)\n[![GitHub issues](https://img.shields.io/github/issues/sifive/templates-xpack.svg)](https://github.com/sifive/templates-xpack/issues/)\n[![GitHub pulls](https://img.shields.io/github/issues-pr/sifive/templates-xpack.svg)](https://github.com/sifive/templates-xpack/pulls/)\n\n# Maintainer info\n\nThis file documents the procedure used to make releases.\n\n## Prepare the release\n\nBefore making the release, perform some checks and tweaks.\n\n### Update npm packages\n\n- `npm outdated`\n- edit `package.json` and `npm install`\n- repeat until everything is up to date\n\n### Check Git\n\nIn this Git repo:\n\n- in the `develop` branch\n- push everything\n- if needed, merge the `master` branch\n\n### Determine the next version\n\nUse the semantic versioning semantics.\n\nEdit `package.json` to this version suffixed by `-pre`.\n\n### Fix possible open issues\n\nCheck GitHub issues and pull requests:\n\n- \u003chttps://github.com/sifive/templates-xpack/issues/\u003e\n\n### Update versions in the README files\n\n- update version in `README-MAINTAINER.md`\n- check the rest of the file and update if needed, to reflect the new features\n- update version in `README.md`\n\n## Update `CHANGELOG.md`\n\n- check the latest commits `npm run git-log`\n- open the `CHANGELOG.md` file\n- check if all previous fixed issues are in\n- commit with a message like _prepare v1.2.10_\n\n## Publish on the npmjs.com server\n\n- select the `xpack-develop` branch\n- commit everything\n- `npm run fix`\n- commit all changes\n- `npm run test`\n- check the latest commits `npm run git-log`\n- `npm run pack`; check the content of the archive, which should list\n  only the following; possibly adjust `.npmignore`\n\n```console\nCHANGELOG.md\nLICENSE\nREADME.md\nassets/...\nindex.js\nlib/template.js\npackage.json\n=== Bundled Dependencies ===\n```\n\n- `npm version patch`, `npm version minor`, `npm version major`\n- push all changes to GitHub; this should trigger CI\n- push tag\n- **wait for CI tests to complete**\n- check \u003chttps://github.com/sifive/templates-xpack/actions/\u003e\n- `npm publish --tag next` (use `--access public` when publishing for\n  the first time)\n\nThe version is visible at:\n\n- \u003chttps://www.npmjs.com/package/@sifive/templates?activeTab=versions\u003e\n\n## Testing\n\nThe first test is via `xpm init`\n\n```sh\nmkdir -p ~/tmp/test-sifive \u0026\u0026 cd ~/tmp/test-sifive\nxpm init --template @sifive/templates@next --property boardName=hifive1\nxpm install\nxpm run build\n```\n\nThe project also includes unit tests, which create multiple projects,\nwith combinations of properties.\n\nTo run them, use:\n\n```sh\ncd sifive-templates-xpack.git\nxpm install\nxpm run test\n```\n\n## Continuous Integration\n\nAll available tests are also performed on GitHub Actions, as the\n[CI on Push](https://github.com/micro-os-plus/sifive-templates-xpack/actions/workflows/CI.yml)\nworkflow.\n\n## Update the repo\n\nWhen the package is considered stable:\n\n- with a git client\n- merge `xpack-develop` into `xpack`\n- push to GitHub\n- select `xpack-develop`\n\n## Tag the npm package as `latest`\n\nWhen the release is considered stable, promote it as `latest`:\n\n- `npm dist-tag ls @sifive/templates`\n- `npm dist-tag add @sifive/templates@1.2.10 latest`\n- `npm dist-tag ls @sifive/templates`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro-os-plus%2Fsifive-templates-xpack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicro-os-plus%2Fsifive-templates-xpack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro-os-plus%2Fsifive-templates-xpack/lists"}