{"id":15774420,"url":"https://github.com/zomars/nutflow","last_synced_at":"2025-08-22T12:05:53.847Z","repository":{"id":25987451,"uuid":"104592457","full_name":"zomars/nutflow","owner":"zomars","description":"Nutflow helps you create a Bolt CMS website easily and setup an automated development environment.","archived":false,"fork":false,"pushed_at":"2022-07-07T07:05:03.000Z","size":1242,"stargazers_count":4,"open_issues_count":17,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-15T03:55:03.693Z","etag":null,"topics":["bolt-cms","gulp","inuitcss","sass","webpack"],"latest_commit_sha":null,"homepage":null,"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/zomars.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":"2017-09-23T19:11:15.000Z","updated_at":"2022-04-21T12:42:55.000Z","dependencies_parsed_at":"2022-08-07T11:16:15.933Z","dependency_job_id":null,"html_url":"https://github.com/zomars/nutflow","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zomars/nutflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zomars%2Fnutflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zomars%2Fnutflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zomars%2Fnutflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zomars%2Fnutflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zomars","download_url":"https://codeload.github.com/zomars/nutflow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zomars%2Fnutflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271635439,"owners_count":24794140,"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-08-22T02:00:08.480Z","response_time":65,"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":["bolt-cms","gulp","inuitcss","sass","webpack"],"created_at":"2024-10-04T16:21:42.494Z","updated_at":"2025-08-22T12:05:53.821Z","avatar_url":"https://github.com/zomars.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Introduction\n\nNutflow helps you create a Bolt CMS website easily and setup an automated development environment.\n\nEverything here is built directly with Gulp, and is based on and built around multiple sources like [Boltflow](http://boltflow.work/), [Fabrica Dev Kit](https://github.com/fabrica-wp/fabrica-dev-kit) and [Automate Your Workflow](https://automateyourworkflow.com/).\n\n## Installation\n\nDownload the zip folder (or clone the repository), extract it,then run the following commands to install all dependencies required:\n\n```bash\n$ yarn\n```\n\n## Project Structure\n\nNutflow's project is divided into four main folders:\n\n- `config`\n- `gulp`\n- `src`\n- `www`\n\n`config` is where you keep track of Bolt configuration files, these will be automatically copied to `./www/app/config` folder. Except for the `deploy.yml` file, which will be copied and renamed to `./www/.deploy.yml`.\n\n`src` is where you would place all your source files. This includes all your code, images, fonts and everything else.\n\nThese files will then be treated and copied over to the default Bolt themes folder `./www/public/theme/base-inuitcss_dev` or `./www/public/theme/base-inuitcss` depending on whether you're developing or creating an optimized build.\n\n## Development\n\nYou begin the development phase with the `gulp` command:\n\n```bash\n$ gulp\n```\n\nWhen `gulp` is ran, Nutflow will look through all your source folders and execute the following tasks:\n\n- `configs` - Copies configuration files to `./www/app/config`\n- `clean` - to clean the `_dev` theme directory\n- `lint:js` - Check for code formats\n- `images` - Copies images to `_dev` theme folder\n- `fonts` - Copies fonts to `_dev` theme folder\n- `sass` - Compiles Sass into CSS (Also lint sass files)\n- `server` - Runs Bolt included php server\n- `webpack` - Compiles JavaScript with Webpack\n- `browserSync` - Launches browser for live-reload\n- `watch` - watch files for changes.\n\nYou can find the configurations for each of these tasks in `gulp/task/task-name.js`.\n\nYou can also duplicate and rename the 'secrets.json.dist' file as '.secrets.json', to keep off private configurations from git.\n\nOnce the command has finished executing, you can navigate to `localhost:3000` to view your website. Everything here is placed in the `www` folder.\n\n### Writing Sass\n\nSass files are kept in the `src/scss` directory. They are pre-configured to import libraries from both `bower_components` and `node_modules` folders. You can use the `@import` statement to import these modules without having to refer to the `bower_components` or `node_modules` folder.\n\n```scss\n// Importing Sass MQ.\n// No need to add `bower_components` or `node_modules` folder\n@import \"sass-mq/mq\";\n```\n\n### Writing JavaScript\n\nJavaScript files are kept in the `src/js` folder. They are compiled from ES6 syntax to ES5 syntax with Webpack. Feel free to write ES6 immediately within any file located in `src/js`.\n\n```js\n// ES5 syntax\nvar _ = require('lodash');\n\n// ES6 Syntax\nimport _ from 'lodash';\n```\n\n### Adding Images\n\nAll images are to be placed in the `src/images` directory.\n\n#### Templates Folder\n\n`src/templates` contain all `.twig` template files. This is also the location where you add files (like partials and macros) that can be imported into other `.twig` files.\n\n### Summary for Development Phase\n\nIn short, here are the files you'd want to touch:\n\n- `src/sass` – For Sass files\n- `src/js` – For JavaScript files\n- `src/images` – For images\n- `src/templates` – For Twig templates, partials, macros and everything else you use in Twig.\n- `config` – For tracking Bolt configuration files.\n\n### A Quick Note on Watching\n\nNutflow watches every file you need, and automatically regenerates all your files whenever you save a `.twig`, `.scss`, `.js` file in the folders mentioned above.\n\nThe only thing to note is that Nutflow doesn't know when you have added a new file into the `src` folder. It cannot regenerate your site in this case.\n\nHence, whenever you add a new file into `gulp.src`, you must re-run the `gulp` command.\n\n## Optimization Phase\n\nNutflow is built to optimize your entire website in one single command: `gulp --prod`.\n\n```bash\n$ gulp --prod\n```\n\nThe `--prod` flag is a custom flag introduced to tell Nutflow that you're building a optimized site for production. Nutflow will then run through the following tasks and create an optimized theme in the `./www/public/themes/` folder.\n\n## Deployment Phase\n\nNutflow has two built-in methods to help you deploy your website. They are `rsync` and `simple`.\n\nYou can set the deploy method by changing the `deploy` key in `gulp/config.js`.\n\nMake sure you edit the `deploy.yml` file located in th the `config` folder.\n\n## Bugs \u0026 Contributing\n\nYou can list your bugs \u0026 issues under the issue tracker in Github.\n\nFeel free to pull the repo and contribute as well.\n\n## Final notes\n\nFree feel to play around with the Gulp configurations in `gulp/config.js` if you want to change your settings.\n\nLet me know if you run into problems, or if you want some additional functionality. I'll see if I'm able to incorporate them.\n\nIt'll also be awesome if you think of ways to make this generator even better! :)\n\nHave fun!\n\n## Changelog\n\n#### 1.0.0\n\n- Initial Commit\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzomars%2Fnutflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzomars%2Fnutflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzomars%2Fnutflow/lists"}