{"id":19425461,"url":"https://github.com/bcgov/bootstrap-v5-theme","last_synced_at":"2025-04-24T16:31:37.718Z","repository":{"id":235543110,"uuid":"790888250","full_name":"bcgov/bootstrap-v5-theme","owner":"bcgov","description":"The new home for the new bootstrap v5 themed BC Gov. look-and-feel","archived":false,"fork":false,"pushed_at":"2024-05-07T22:27:51.000Z","size":5667,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-13T17:41:10.135Z","etag":null,"topics":["bootstrap5"],"latest_commit_sha":null,"homepage":"https://bcgov.github.io/bootstrap-v5-theme/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bcgov.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}},"created_at":"2024-04-23T17:58:08.000Z","updated_at":"2025-01-12T06:19:12.000Z","dependencies_parsed_at":"2024-05-01T23:40:53.594Z","dependency_job_id":null,"html_url":"https://github.com/bcgov/bootstrap-v5-theme","commit_stats":null,"previous_names":["bcgov/bootstrap-v5-theme"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fbootstrap-v5-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fbootstrap-v5-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fbootstrap-v5-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fbootstrap-v5-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bcgov","download_url":"https://codeload.github.com/bcgov/bootstrap-v5-theme/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250650915,"owners_count":21465253,"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":["bootstrap5"],"created_at":"2024-11-10T14:03:32.556Z","updated_at":"2025-04-24T16:31:35.451Z","avatar_url":"https://github.com/bcgov.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![Lifecycle:Experimental](https://img.shields.io/badge/Lifecycle-Experimental-339999)](https://github.com/bcgov/repomountie/blob/master/doc/lifecycle-badges.md)\n\n# 🚀 Government of British Columbia Bootstrap v5 Theme\n\n[Demonstrations of the theme](https://bcgov.github.io/bootstrap-v5-theme/)\n\nA Bootstrap version 5.3 BC Government look-and-feel featuring:\n\n- The [BC Sans](https://www2.gov.bc.ca/gov/content/governments/services-for-government/policies-procedures/bc-visual-identity/bc-sans) typeface\n- Compatibility with pure Bootstrap markup\n\nThe project is a successor to the previous\n[Gov-4.0-Bootstrap-theme](https://github.com/bcgov/bootstrap-theme)\n[Gov-2.0-Bootstrap-Skeleton](https://github.com/bcgov/Gov-2.0-Bootstrap-Skeleton)\nand [mygovbc-bootstrap-theme](https://github.com/bcgov/mygovbc-bootstrap-theme).\nWe combined the best of all projects and leverage the latest\n[Bootstrap](http://getbootstrap.com/) version.\n\n## Usage\n\n- ### Direct Integration with Minified Files\n\n    You can directly use the minified CSS and JS files in your project. The minified CSS file to link can be found via this [path](dist/css/bootstrap-theme.min.css):\n\n    `dist/css/bootstrap-theme.min.css`\n\n    To ensure dropdowns, tooltips, and popovers function properly, you can import the minified JS file into your project. which can be found via this [path](dist/js/bootstrap-theme.min.js):\n\n    `dist/js/bootstrap-theme.min.js`\n\n    These files can be added to your project's `\u003chead\u003e` section:\n\n    ```html\n    \u003chead\u003e\n    ...\n        \u003cscript defer=\"defer\" src=\"js/bootstrap-theme.min.js\"\u003e\u003c/script\u003e\n        \u003clink href=\"css/bootstrap-theme.min.css\" rel=\"stylesheet\"\u003e\n    \u003c/head\u003e\n    ```\n\n- ### SCSS To Modify Variables/Themes\n\n    This section describes how to change the theme or remove unneeded CSS\n\n    - #### Tool Setup\n\n        You'll need the following tools installed on your device:\n        \n        * [NodeJS 20 LTS+](https://nodejs.org/en/) with NPM 10+ to build\n\n    - #### First Install\n\n        After your tools are in place, you should install some packages. In the working directory:\n\n        ```bash\n        git clone https://github.com/bcgov/bootstrap-v5-theme.git\n        cd bootstrap-v5-theme\n        npm install\n        ```\n\n    - #### Building Dist\n\n        To build the styles, JavaScript and other assets, use:\n\n        ```bash\n        npm run build\n        ```    \n\n        Or for continuous building and real-time updates as you make changes:\n\n        ```bash\n        npm start\n        ```        \n\n- ### Migration Guide From Version 4 to 5\n\n    The [CHANGELOG](CHANGELOG.md) outlines the majority of classes and changes needed for migration, allowing you to easily refer to and perform search and replace where necessary.\n\n    If you need to add or modify utilities, you can consult the official [bootstrap migration guide](https://getbootstrap.com/docs/5.3/migration/) for a comprehensive list of changes.\n\n## Extending the Theme\n\nRefer to the [official Bootstrap documentation](https://getbootstrap.com/docs/5.3/extend/approach/) to learn about extending or enhancing this theme. \n\nTooling and build follow the same steps as [SCSS To Modify Variables/Themes section](#scss-to-modify-variablesthemes)\n\n# NPM Package\n\nhttps://www.npmjs.com/package/@bcgov/bootstrap-v5-theme\n\n\n## NPM Package Maintenance\n\nIf you would like to update the project and would like to push your changes to the npm registry, the following will be useful.\nTo push to the npm registry, you must ensure that the version number has been updated to reflect any of the changes that you’ve made. Upon following semantic versioning, and updating the version number in `package.json`  you can then publish the package in your own namespace.\n\n1. Ensure you are logged into your npm account. To log in via the terminal, run the following:\n\n```bash\nnpm login\n```\n\n- upon successful completion you will see the following: \n\n```bash\nLogged in on https://registry.npmjs.org/.\n```\n\n2. Now you can publish your package\n\n    - Run the following command in your termnial\n    \n```bash\nnpm publish --access=public\n```\n\nIf you are publishing to a namespace, you will have to ensure that `--acess=public` is included in your run command as packages for an org are private by default\n\n\nNote: You can test your changes locally by changing the name in the package.json to `@\u003cyour-namespace\u003e/bootstrap-v5-theme` and publishing there. Once you are satisfied, you can republish to the @bcgov org.\n    \n\n## Updating the Theme\n\nIf Bootstrap has a minor update and you wish to update the minified CSS and JS files, do the following:\n1. Run `npm run build` in order to build the needed assests.\n2. Mark a new release on GitHub \n3. Publish the updated dist folder to NPM JS Registry as a new NPM package version\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcgov%2Fbootstrap-v5-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbcgov%2Fbootstrap-v5-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcgov%2Fbootstrap-v5-theme/lists"}