{"id":15170990,"url":"https://github.com/argyleink/bolt","last_synced_at":"2025-10-25T21:32:01.245Z","repository":{"id":17750518,"uuid":"20599853","full_name":"argyleink/Bolt","owner":"argyleink","description":"⚡ is a fast grunt based, data driven, static site seed project, for rapid web development of PWA's or JAMstack projects","archived":false,"fork":false,"pushed_at":"2016-11-06T04:58:19.000Z","size":934,"stargazers_count":37,"open_issues_count":4,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-02-06T14:11:44.389Z","etag":null,"topics":["coffeescript","data-driven","grunt","jamstack","mobile-first","offline-first","pug","static-site-generator","stylus"],"latest_commit_sha":null,"homepage":"http://argyleink.github.io/Bolt","language":"HTML","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/argyleink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-06-07T18:29:29.000Z","updated_at":"2024-10-24T01:01:02.000Z","dependencies_parsed_at":"2022-08-30T05:52:51.251Z","dependency_job_id":null,"html_url":"https://github.com/argyleink/Bolt","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argyleink%2FBolt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argyleink%2FBolt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argyleink%2FBolt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argyleink%2FBolt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/argyleink","download_url":"https://codeload.github.com/argyleink/Bolt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238212425,"owners_count":19434955,"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":["coffeescript","data-driven","grunt","jamstack","mobile-first","offline-first","pug","static-site-generator","stylus"],"created_at":"2024-09-27T08:42:42.288Z","updated_at":"2025-10-25T21:31:55.897Z","avatar_url":"https://github.com/argyleink.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"http://www.hipsterlogogenerator.com/\"\u003e\n    \u003cimg src=\"https://dl.dropboxusercontent.com/u/6515442/hipsterlogogenerator_1422411720676.png\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Goal\nOffer a **fast**, Grunt based, data driven malleable static build system. Use it for any project architecture that makes html/css/js. \n\n## Overview\nThis project seed is cache heavy, smart loading, and mobile first out of the box. [Jade](http://jade-lang.com/) \u0026 [Stylus](http://learnboost.github.io/stylus/) are the preprocessor defaults, but swap it for whatever you want, no limits. Want more than 1 preprocessor, it's ready. Add tasks, take care of business.\n\n![Build Status](https://travis-ci.org/argyleink/Bolt.svg?branch=master)\n[![Join the chat at https://gitter.im/argyleink/Bolt](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/argyleink/Bolt?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n#### Required\n- [Node.js](http://nodejs.org/) and NPM\n- [Grunt](http://gruntjs.com/)\n\n#### Optional (but handy)\n- [Bolt CLI](https://github.com/argyleink/Bolt-cli)\n- [Bower](http://bower.io/)\n\n#### Quickstart\n1. `npm i -g bolt-cli`: very small simple tool to install bolt into directories\n2. `bolt new my_site`: my_site should be replaced with your project name\n3. `cd bolt-test \u0026\u0026 npm i`: install bolt dependencies\n4. `grunt`: spin it up!\n5. See the [Wiki](https://github.com/argyleink/Bolt/wiki)\n\nor \n\n1. `npm i`\n2. `grunt`\n\n## Build Features\n- Dev builds are extremely legible, source mapped, and ready for debugging with your tools `grunt`\n- Production builds squish the crap out [images,css,html,js,svg] `grunt prod`\n- Dev and Prod builds have their own output directory, they don't share a `dist/` folder. No need for one build to squash the other.\n- Very fast, with a jit plugin for really fast task running\n- Concise [Grunt main file](https://github.com/argyleink/Bolt/blob/master/gruntfile.coffee)\n- [Grunt tasks](https://github.com/argyleink/Bolt/tree/master/tasks) are individual, short, easy as hell to read, and a breeze to create\n- DRY [Configuration file](https://github.com/argyleink/Bolt/blob/master/app.coffee) keeps project assets and options centralized\n- [BrowserSync](http://www.browsersync.io) dev server syncs all your clicks, scrolls, and more during development\n- BrowserSync live reload and hot css pushes for really rad fast front end crafting\n- BrowserSync Weinre remote inspect built in\n- Externally accessible server\n- Proper [Jade inheritance](https://github.com/paulyoung/jade-inheritance) compilation, so 1 file changed doesn't require the whole project to compile\n- Data driven front end development with YAML and/or JSON\n- [Auto generated](https://github.com/argyleink/Bolt/blob/master/tasks/manifest.coffee) HTML5 appcache for production builds\n- Autoprefixed Stylus\n- Git tagging and releasing `grunt bump`\n- Easily create custom [build notifications](https://github.com/argyleink/Bolt/blob/master/tasks/notify.coffee)\n- Customize your crunched files comment banner\n- Ready to run custom [shell commands](https://github.com/argyleink/Bolt/blob/master/tasks/shell.coffee)\n- Image crunching\n- [Sublime project file](https://github.com/argyleink/Bolt/blob/master/app.sublime-project) for easy project editing and standards establishment\n- [CLI](https://github.com/argyleink/Bolt-cli) for easy setup of new projects `bolt new my_app`\n\n#### Bolt Commands\n- `grunt`: dev server, no crunching, source maps, live reload, fast\n- `grunt --dont-open`: dev time, but don't open it in a browser for me\n- `grunt prod`: prod server, turbo crunching, no maps, ready to test before tagging or pushing\n- `grunt compile`: all the features of prod, but no server, just the crunched output\n- `grunt serve --target=dev` or `grunt serve --target=prod`: serve previous builds\n\n#### Bolt Extras\n- YAML data files are fed directly into your static site template system as JSON\n- [Mobile first](https://github.com/argyleink/Bolt/blob/master/app/styles/base/_vars.styl)\n- [Flexboxgrid](http://flexboxgrid.com/) library preloaded\n- Extensable [Jade page](https://github.com/argyleink/Bolt/blob/master/app/_jade/layouts/page.jade) structure\n- Great [Stylus base](https://github.com/argyleink/Bolt/tree/master/app/styles)\n- Tons of [mobile header](https://github.com/argyleink/Bolt/tree/master/app/_jade/includes/mobile) and icons, tested and ready\n- HTML5 [manifest.json](https://github.com/argyleink/Bolt/blob/master/app/manifest.json)\n- 404 page\n- [Robots.txt](https://github.com/argyleink/Bolt/blob/master/app/robots.txt)\n- Pretty much a progressive web app starter\n\n#### Interesting Bolt Branches\n- **koa:** a server rendering seed\n- **isomorphic:** client side and static seed\n- **remote-data:** fetch remote data from an api and build a static site from it\n- **webpack:** webpack starter\n\n## Inspiration\n- [Roots](http://roots.cx/)\n- [Yeoman](http://yeoman.io/)\n- [Google Web Starter Kit](https://developers.google.com/web/starter-kit/)\n- [HTML5 Mobile Boilerplate](https://github.com/h5bp/html5-boilerplate)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fargyleink%2Fbolt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fargyleink%2Fbolt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fargyleink%2Fbolt/lists"}