{"id":28533558,"url":"https://github.com/esri/calcite-bootstrap","last_synced_at":"2025-06-30T07:33:33.358Z","repository":{"id":56349703,"uuid":"37480089","full_name":"Esri/calcite-bootstrap","owner":"Esri","description":"A Calcite theme and a custom build system for building Bootstrap apps.","archived":false,"fork":false,"pushed_at":"2020-11-12T22:21:41.000Z","size":2128,"stargazers_count":48,"open_issues_count":35,"forks_count":29,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-06-28T07:40:21.921Z","etag":null,"topics":["bootstrap","calcite","calcite-bootstrap","css","esri","sass","theme","web-development"],"latest_commit_sha":null,"homepage":"http://esri.github.io/calcite-bootstrap/","language":"SCSS","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/Esri.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}},"created_at":"2015-06-15T17:29:41.000Z","updated_at":"2025-04-14T19:00:45.000Z","dependencies_parsed_at":"2022-08-15T17:01:16.832Z","dependency_job_id":null,"html_url":"https://github.com/Esri/calcite-bootstrap","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/Esri/calcite-bootstrap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esri%2Fcalcite-bootstrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esri%2Fcalcite-bootstrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esri%2Fcalcite-bootstrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esri%2Fcalcite-bootstrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Esri","download_url":"https://codeload.github.com/Esri/calcite-bootstrap/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esri%2Fcalcite-bootstrap/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262731737,"owners_count":23355410,"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":["bootstrap","calcite","calcite-bootstrap","css","esri","sass","theme","web-development"],"created_at":"2025-06-09T17:07:42.065Z","updated_at":"2025-06-30T07:33:33.346Z","avatar_url":"https://github.com/Esri.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"### This project is deprecated and is not recommended for future development.\n\n# Calcite Bootstrap\n\n**Calcite Bootstrap** is a custom theme and a custom build system for [Bootstrap](http://getbootstrap.com). The theme is based on **Calcite** - a geo-centric design framework created by Esri. Calcite Bootstrap was built for developers who have experience working with Bootstrap and would like to integrate the Calcite theme and build system to their web pages and apps.\n\nFor more info about this framework, go to the **[documentation site](http://esri.github.io/calcite-bootstrap/)**\n\n# Using Calcite Bootstrap\n\nThere are two main ways to use Calcite Boostrap:\n- 1, Copying compiled css files into your project; or\n- 2, Installing via a npm and using a SASS build step in your project.\n\n## Bootstrap Javascript Components\nCalcite Bootstrap does not include any javascript components itself - it simply provides a theme for Bootstrap components. If you elect to use any Bootstrap components that require javascript, you will need to include the Bootstrap javascript in your application.\n\nFor applications without a build system, we recommend loading the Bootstrap javascript from the [BootstrapCDN](https://www.bootstrapcdn.com/).\n\nIf you have a build step, and installed calcite-bootstrap via npm, then bootstrap-sass was also installed, and you can include the scripts you need from `node_modules/bootstrap-sass/assets/javascripts/...`\n\n\n## Static Files\n\nThis is probably the easiest way. If you're looking to get up and running quickly, just [download the latest release](https://github.com/esri/calcite-bootstrap/releases) and move the zipped files to wherever you keep you assets. Be sure to use [the documentation site](http://esri.github.io/calcite-bootstrap/) and the main [Bootstrap](http://getbootstrap.com) to copy and paste patterns, components, and even a sample html boilerplate.\n\n## NPM\n\nTo install Calcite Bootstrap with npm, type:\n\n```\nnpm install --save-dev calcite-bootstrap\n```\n\nIf you're using sass, be sure to add `node_modules/calcite-bootstrap/dist/sass/` to your load path. If you're using [`gulp-sass`](https://github.com/dlmanning/gulp-sass) you will add something like this:\n\n```\ngulp.task('sass', function () {\n return gulp.src('./sass/**/*.scss')\n   .pipe(sass({\n     includePaths: [\n      './node_modules/bootstrap-sass/assets/stylesheets',\n      './node_modules/calcite-bootstrap/dist/sass/'\n     ]\n    }).on('error', sass.logError))\n   .pipe(gulp.dest('./css'));\n});\n```\n\nIf you are using [`grunt-sass`](https://github.com/sindresorhus/grunt-sass), you should add it like this:\n\n```\n'sass': {\n  options: {\n    includePaths: [\n      './node_modules/bootstrap-sass/assets/stylesheets',\n      './node_modules/calcite-bootstrap/dist/sass/'\n    ]\n  },\n  target: {\n    files: {\n      'path/to.css': 'path/to.scss'\n    }\n  }\n}\n```\n\nThen in your main `.scss` file, you can just require the framework: `@import \"calcite-bootstrap\";`.\n\n# Contributing to Calcite Bootstrap\n\nInstalling Calcite Bootstrap was designed to be fairly painless. If you have any problems, be sure to [submit an issue](https://github.com/Esri/calcite-bootstrap/issues/) and use the label `install issues`.\n\n\n### Install Dependencies\n\nCalcite-Boostrap has these main dependencies:\n\n- node.js\n- gulp\n\n1. Open Terminal (or your favorite command line tool. For OSX, I recommend iTerm) and check to see if you have Git installed just by entering `$ git`. You should see a list of commands for git if it is. If Git is not installed, OSX will automatically prompt you to install the XCode Command Line Developers Tools. Follow the prompts to complete the install.\n2. Visit [nodejs.org](http://nodejs.org/) to install Node. Check the install by entering `$ node -v` in Terminal\n3. Install Grunt by entering `$ npm install -g gulp` in Terminal.\n\nIf you run into errors during the installs, Mac Users my want to try using `sudo`. For example:\n\n`$ sudo npm install -g gulp`\n\n### Fork the Repository\n\nAll the code for Calcite Bootstrap lives [on GitHub](https://github.com/Esri/calcite-bootstrap). We use the [fork and pull model](https://help.github.com/articles/using-pull-requests/) to manage contribution.\n\n1. Fork the repository so you have your own copy (`$ your-username/calcite-bootstrap`)\n2. Clone the repo locally with `$ git clone https://github.com/your-username/calcite-bootstrap`\n3. Move into the clone repo:  `$ cd calcite-bootstrap`\n\n### Setting up the Repository\n\n1. Install npm modules: `$ npm install`\n\nAgain, if you run into errors during, Mac Users my want to try using `sudo`.\n\nWhen the installs complete run `$ gulp serve` to start the application. Open a new browser and navigate to `http://localhost:9000`.\n\n### Git Remote\nYou should also add `Esri/calcite-bootstrap` as a remote at this point. We generally call this remote branch 'upstream':\n\n```\n$ git remote add upstream https://github.com/Esri/calcite-bootstrap\n```\n\nCheck your configuration: `$ git remote -v`\n\nThe results should look like:\n```\norigin\thttps://github.com/your-username/calcite-bootstrap.git (fetch)\norigin\thttps://github.com/your-username/calcite-bootstrap.git (push)\nupstream\thttps://github.com/Esri/calcite-bootstrap.git (fetch)\nupstream\thttps://github.com/Esri/calcite-bootstrap.git (push)\n```\n\n\n\n\n### Releasing to NPM\nTo prepare a release, you need an NPM account (npmjs.org), and need to be running on a mac or linux.\n\nMost of the process is automated, but we have left two manual steps to ensure that the actual publishing to NPM is not done accidentally.\n\n1. increment the version number in `package.json` This will usually mean bumping the PATCH number (major.minor.patch). This version number will be used in the TAG that the next step will create @ github.\n1. run `sh bin/release.sh` This will create a branch, build the css, and pushes a release. NOTE: You can only push to the same version once. Re-release on the same version, you must manually destroy the release @ github.\n1. Got to the release @ github [https://github.com/Esri/calcite-bootstrap/releases](https://github.com/Esri/calcite-bootstrap/releases) and copy the url to the tar.gz source code file.\n1. run `npm publish \u003curl to tar.gz file\u003e` - this will push the update to npm.\n\n## Licensing\n\nCopyright \u0026copy; 2015-2018 Esri\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\nA copy of the license is available in the repository's [LICENSE](./LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesri%2Fcalcite-bootstrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesri%2Fcalcite-bootstrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesri%2Fcalcite-bootstrap/lists"}