{"id":32258454,"url":"https://github.com/spacenomads/asteroids","last_synced_at":"2025-10-22T19:49:08.778Z","repository":{"id":34547424,"uuid":"38492059","full_name":"spacenomads/Asteroids","owner":"spacenomads","description":"Yep, a gulp-ready-nunjucks-lover-sass-powered-and-humanstxt-included html starter kit!","archived":false,"fork":false,"pushed_at":"2025-08-25T20:38:46.000Z","size":2430,"stargazers_count":17,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-22T19:48:56.227Z","etag":null,"topics":["gulp","hacktoberfest","humanstxt","jquery","nodejs","nunjucks-starter-kit","nunjucks-templates","sass","starter-kit","web-starter-kit"],"latest_commit_sha":null,"homepage":"","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spacenomads.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2015-07-03T12:39:20.000Z","updated_at":"2025-03-30T00:41:58.000Z","dependencies_parsed_at":"2023-01-15T07:42:20.797Z","dependency_job_id":"25c98052-7981-438d-9128-7dacc3f49107","html_url":"https://github.com/spacenomads/Asteroids","commit_stats":{"total_commits":120,"total_committers":4,"mean_commits":30.0,"dds":"0.30000000000000004","last_synced_commit":"fbf8f4c81a7080a955e67f813c7fc94d45024c37"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/spacenomads/Asteroids","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenomads%2FAsteroids","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenomads%2FAsteroids/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenomads%2FAsteroids/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenomads%2FAsteroids/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spacenomads","download_url":"https://codeload.github.com/spacenomads/Asteroids/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenomads%2FAsteroids/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280503191,"owners_count":26341693,"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-22T02:00:06.515Z","response_time":63,"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":["gulp","hacktoberfest","humanstxt","jquery","nodejs","nunjucks-starter-kit","nunjucks-templates","sass","starter-kit","web-starter-kit"],"created_at":"2025-10-22T19:49:06.049Z","updated_at":"2025-10-22T19:49:08.771Z","avatar_url":"https://github.com/spacenomads.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Asteroids\n\n![GitHub package.json version (branch)](https://img.shields.io/github/package-json/v/spacenomads/Asteroids/main?label=Version\u0026labelColor=414141\u0026color=ffcc00)\n [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?labelColor=%23414141\u0026color=%23ffcc00)](code_of_conduct.md)\n\nAhoy! This kit is my all-new/all-old web starter kit. Use it well!\n\n\u003ccenter\u003e\n\u003cimg src=\"asteroids-700.png\" width=\"350\" alt=\"\"\u003e\n\u003c/center\u003e\n\nWith the help of [Gulp](https://gulpjs.com) and [11ty](https://www.11ty.dev/), Asteroids includes SCSS processing, JS minification and [Nunjucks](https://mozilla.github.io/nunjucks/), a super cool template engine created by Mozilla.\n\n## Required steps: Installing Node and Gulp\n\nTo run Asteroids you'll need to have Node and Gulp installed:\n\n- [NodeJS](https://nodejs.org/en) LTS version should be okay.\n- [Gulp](https://gulpjs.com/) globally installed.\n\n\u003e 🤓 Running on Windows? Just remember to use the Git Bash console instead of that horrible thing called PowerShell.\n\n### NodeJS\n\nGo to the [official NodeJS website](https://nodejs.org/en) and download the version that best suits you. The LTS version should work fine. Install it, and your done :)\n\nYou can check if everything went okay by opening a terminal window and typing:\n\n```shell\nnode -v\n```\n\n## Gulp\n\nWe'll need Gulp to process our SCSS and JS files because Eleventy doesn't do this.\nGo to the [official Gulp website](https://gulpjs.com/docs/en/getting-started/quick-start) and follow the installing instructions. They should be something like open a terminal and type:\n\n```shell\nnpm install --global gulp-cli\n```\n\nBut it's best to check it out ;)\n\nYou can also check that everything went the way it was supposed to by opening a new terminal window and typing:\n\n```shell\ngulp -v\n```\n\n## Quickstart\n\nOnce you've installed both NodeJS and Gulp, let's run this starter kit:\n\n1. Download or clone the repository.\n2. Install the local dependencies with `$ npm i`.\n3. Run the kit development stuff with `$ npm start`.\n\n## Tasks\n\n### Launch a web server for development\n\n```shell\n$ npm start\n```\n\nLaunch Eleventy in serve mode and run some Gulp tasks to keep an eye on your SCSS/JS files to process and reload your project on port 8080\n\n### Process a production-ready distribution\n\n```shell\n$ npm run build:pro\n```\n\nDelete and reprocess the dist folder with optimized versions of your HTML/CSS/JS files.\n\n### Compress a production-ready distribution\n\n```shell\n$ gulp zipit\n```\n\nDelete and reprocess the public folder with optimized versions of your HTML/CSS/JS files and compress it in a .zip file.\n\nThe task picks the name of the project from the package.json \"name\" property.\n\nIt will generate an ignored `DDMMYY-hm-project-name.zip` file\n\n## Folder structure\n\nThe **gulpfile.js** uses a configuration JSON file to set source and destination files of the project.\nCheck config.json out and edit what you need.\n\nThe project folder structure looks like this:\n\n```txt\n/.\n├── _src/\n│   ├── _data/\n│   │   └── settings.js\n│   ├── _templates/\n│   │   └── layouts/\n│   ├── assets/\n│   │   ├── _domain/\n│   │   ├── _icon/\n│   │   ├── _scripts/\n│   │   ├── _scss/\n│   │   ├── css/\n│   │   ├── fonts/\n│   │   ├── images/\n│   │   └── js/\n│   └── index.njk\n└── dist/\n    ├── CNAME\n    ├── assets/\n    │   ├── css/\n    │   ├── fonts/\n    │   ├── images/\n    │   └── js/\n    ├── favicon.ico\n    ├── humans.txt\n    └── index.html\n\n```\n\n## CSS\n\nAsteroids do not include a CSS reset stylesheet anymore, but we have added two awesome tools:\n\n- A **csscomb** JSON file to use with your code editor as your own risk :)\n- The media query combiner tool from @hail2u [**css-mqpacker**](https://github.com/hail2u/node-css-mqpacker/pkgs/npm/css-mqpacker).\n\n## LINTERS AND STUFF\n\nA few linter configurations are also included in Asteroids: Eslint, Stylelint and Markdown lint. You may need certain plugins or extensions for your code editor in order to use them.\n\n\u003e 👉 There is no such thing as a pre commit configuration or autoformat setting, these linters are only meant to show \"problems\" as you edit any JS/SCSS/MD file.\n\n## Browser Support\n\nThat's up to you :), although you can find a \"browserlist\" property for the autoprefixer in the package.json file.\n\n## TODO\n\nSo, what is next?\n\n- [ ] Use SASS Dart.\n- [ ] Process JS files: minify and obfuscate?\n- [ ] Add a GitHub Pages action.\n- [ ] Mobile icons + PSD source file.\n- [X] Gulp task to generate a timestamped deploy folder. @done\n- [X] Add CSS Linters. @done\n- [X] Add JS Linters. @done\n- [X] Use EJS/Nunjucks instead of PUG. @done\n- [X] Quit using Jquery. @done\n- [X] Migrate to 11ty. @done\n- [X] ~~Update modernizr checkers~~. @wontDoIt\n- [X] ~~Fix PUG/HTML reload loop~~. @wontDoIt\n\n## Request a feature\n\nDo you miss anything? Feel free to [request a feature](https://github.com/spacenomads/Asteroids/issues/new?assignees=oneeyedman\u0026labels=%F0%9F%92%A1+New%21\u0026template=---feature-request.md\u0026title=) or contribute to making it better ;)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacenomads%2Fasteroids","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacenomads%2Fasteroids","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacenomads%2Fasteroids/lists"}