# generator-baumeister

> Yeoman Generator for »Baumeister«. The aim of this project is to help you to build your things. From Bootstrap themes over static websites to single page applications.

Latest version **4.0.2** (published 2021-10-15) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install generator-baumeister
pnpm add generator-baumeister
yarn add generator-baumeister
bun add generator-baumeister
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 4.0.2 |
| Published | 2021-10-15 |
| First published | 2017-05-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=6.0.0 |
| Dependencies | 9 |
| Unpacked size | 182.1 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 52 |
| Author | Michael Kühnel |
| Maintainers | mischah, krnlde, chrkhl |
| Keywords | yeoman-generator, bootstrap, boilerplate, skeleton, scaffolding, scaffold, theme, themes, kickstart, kickstarter, micromata, workflow, build, webpack, static site generator, baumeister, handlebars, single page application, single page applications, es6, jest |

## Links

- npm: https://www.npmjs.com/package/generator-baumeister
- Repository: https://github.com/micromata/generator-baumeister
- Issues: https://github.com/micromata/generator-baumeister/issues
- npm.io page: https://npm.io/package/generator-baumeister

## Dependencies (9)

- [chalk](https://npm.io/package/chalk.md) ^2.4.2
- [yosay](https://npm.io/package/yosay.md) 2.0.2
- [global](https://npm.io/package/global.md) 4.3.2
- [semver](https://npm.io/package/semver.md) 5.6.0
- [superb](https://npm.io/package/superb.md) 3.0.0
- [common-tags](https://npm.io/package/common-tags.md) ^1.8.0
- [command-exists](https://npm.io/package/command-exists.md) 1.2.8
- [yeoman-generator](https://npm.io/package/yeoman-generator.md) 3.2.0
- [underscore.string](https://npm.io/package/underscore.string.md) 3.3.5

## Alternatives

- [raw-loader](https://npm.io/package/raw-loader.md) — 4.3M weekly downloads
- [plop](https://npm.io/package/plop.md) — 1.4M weekly downloads
- [webpack-deadcode-plugin](https://npm.io/package/webpack-deadcode-plugin.md) — 80.3K weekly downloads
- [@storybook/preact-vite](https://npm.io/package/@storybook/preact-vite.md) — 54.2K weekly downloads
- [vite-plugin-transform](https://npm.io/package/vite-plugin-transform.md) — 2.4K weekly downloads

## Recent versions

- 4.0.2 (latest) — 2021-10-15
- 4.0.1 — 2019-03-19
- 4.0.0 — 2019-02-20
- 3.1.0 — 2018-05-03
- 3.0.0 — 2018-04-04
- 3.0.0-beta.1 — 2018-03-22
- 3.0.0-beta.0 — 2018-03-18
- 2.0.1 — 2018-02-12
- 2.0.0 — 2018-01-09
- 1.1.1 — 2017-10-24
- 1.1.0 — 2017-08-01
- 1.0.3 — 2017-07-29
- 1.0.2 — 2017-06-25
- 1.0.1 — 2017-06-19
- 1.0.0 — 2017-06-18
- … 1 more at https://npm.io/package/generator-baumeister/versions

## README

[![npm version](https://badge.fury.io/js/generator-baumeister.svg)](http://badge.fury.io/js/generator-baumeister)
[![Build Status](https://travis-ci.org/micromata/generator-baumeister.svg?branch=master)](https://travis-ci.org/micromata/generator-baumeister)
[![Coverage Status](https://coveralls.io/repos/github/micromata/generator-baumeister/badge.svg?branch=master)](https://coveralls.io/github/micromata/generator-baumeister?branch=master) [![Code of Conduct](https://img.shields.io/badge/%E2%9D%A4-code%20of%20conduct-orange.svg?style=flat)](CODE_OF_CONDUCT.md)

## Sorry, this project is unmaintained 😢

We recommend the following tooling:

- React Apps: [Create React Apps](https://reactjs.org/docs/create-a-new-react-app.html) or [Parcel](https://parceljs.org/)
- Static Sites: [Eleventy](https://www.11ty.dev/) or [Awesome Static Web Site Generators](https://github.com/myles/awesome-static-generators)

<hr>

# Yeoman Generator for »Baumeister«

<p align="center">
	<img width="35%" src="https://cdn.rawgit.com/micromata/baumeister-media/49bb43d/dist/Baumeister-Logo-Default.svg" alt="Baumeister Logo">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<img width="31%" src="https://cdn.rawgit.com/yeoman/media/master/optimized/yeoman-600x600-opaque.png" alt="Yeoman Logo">&nbsp;&nbsp;&nbsp;
</p>

Using this generator will give you a solid base for your project in a matter of minutes. No matter if it’s a static website or a single page application.

Baumeister is here to help you to build your things by providing:

- a file structure with focus on maintainability and upgradability
- a build setup based on webpack and npm scripts with the following »features«
	- generate static sites with ease using handlebars templates (optional)
	- transpile, bundle and minify your code (ES6 as well as Sass)
	- visualize size of bundled files with an interactive zoomable treemap
	- remove `console` output and `debugger` statements in production files
	- add vendor prefixes
	- lint JavaScript, Sass and HTML
	- optimize images (lossless)
	- start a local server
	- delete unused CSS (optional)
	- check for known vulnerabilities in dependencies
	- release new versions
	- run unit tests and create coverage reports
	- and more.

Please check the epic [README](https://github.com/micromata/baumeister) of »Baumeister« to get detailed information about what it’s all about.

## Features of this generator

There are tons of options for now :scream:  
… but don’t be afraid – most of them are optional and you probably won’t see them all because some are dependent on others. Plus the ones that probably don’t change from one project to another are stored for your convenience.

| Option  | Description |
| ------------- | ------------- |
| `projectName` | Used in the generated README and package.json  |
| `projectDescription`  | Used in the generated README and package.json  |
| `theme`  | Name of your Bootstrap theme. Used to name a file and a folder within the Sass directory  |
| `projectType` | Adds static site generator abilities (using Handlebars and Frontmatters), if you choose to build a static website. Sets up React with all the bells and whistles, if you choose to build a single page app.  |
| `boilerplateAmount`  | Option to choose the amount of boilerplate code (HTML, Sass and JS examples)  |
| `license`  | Option to define the license type. Defaults to MIT  |
| `initialVersion`  | Option to define the initial version number used in generated package.json. Defaults to 0.0.0  |
| `authorName`  | Option to define the author for use in the generated package.json and JavaScript files  |
| `authorMail`  | Option to define the author for use in the generated package.json and JavaScript files  |
| `authorUrl`  | Option to define the author for use in the generated package.json |
| `projectHomepage`, `projectRepositoryType`, `projectRepository`  | Option to define homepage and repository for use in the generated package.json  |
| `issueTracker`  | Option to define the URL to your issue tracker for use in the generated package.json  |
| `banner`  | Optionally adds a comment banner containing author name, version and build date to your production files (CSS and JS)  |
| `addDistToVersionControl`  | Option to decide whether to add the `dist` directory to version control or include it in `.gitignore` |

Frequent users, who are tired of being asked the same questions over again might like to use a config file called `.yo-rc.json` described [here](#--yo-rc).

---


## Quick install guide

For those already using Yeoman.

```bash
npm install -g generator-baumeister
yo baumeister
```
---

## Dependencies

- Node.js (>=6.0.0)
- Globally installed [Yeoman CLI](https://www.npmjs.com/package/yo)

See detailed installation instructions [over here](https://github.com/micromata/baumeister#dependencies) if you are new to this.

## Getting Started

### What is Yeoman?

Trick question. It's not a thing. It's this guy:

[![Yeoman Logo](yeoman.png "Yeoman Logo")](http://yeoman.io/)

Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.

Not every new computer comes with a Yeoman pre-installed. He lives in the [npm](https://npmjs.org) package repository. You only have to ask for him once, then he packs up and moves onto your hard drive. *Make sure you clean up, he likes new and shiny things.*

```bash
npm install -g yo
```

### Yeoman Generators

Yeoman travels light. He didn't pack any generators when he moved in. You can think of a generator like a plug-in. You get to choose what type of application you wish to create, such as a Backbone application or even a Chrome extension.

To install generator-baumeister from npm, run:

```bash
npm install -g generator-baumeister
```

Finally, initiate the generator:

```bash
yo baumeister
```

### Options via command line flags

#### --skip-cache 

> Do not remember prompt answers for next run of the generator

Default: false

```bash
yo baumeister --skip-cache
```

#### --skip-install

> Do not automatically install dependencies

Default: false

```bash
yo baumeister --skip-install
```

#### --yo-rc

> Read and apply options from .yo-rc.json and skip prompting

Default: false

```bash
yo baumeister --yo-rc
```

You could place a  `.yo-rc.json` in the directory you are going to run the generator or in any parent directory up to your user directory (`~/.yo-rc.json`)

This file should contain the options which are otherwise prompted by Yeoman. See the follwoing example `.yo-rc.json`:

```json
{
  "generator-baumeister": {
    "projectName": "My project",
    "projectDescription": "My projects description",
    "banners": false,
    "projectType": "staticSite",
    "theme": "my-theme",
    "boilerplateAmount": "minimum",
    "license": "MIT",
    "authorName": "Michael Kühnel",
    "authorUrl": "http://www.micromata.de",
    "authorMail": "m.kuehnel@micromata.de",
    "projectHomepage": "https://github.com/micromata/baumeister",
    "projectRepositoryType": "git",
    "projectRepository": "git@github.com:micromata/baumeister.git",
    "issueTracker": "https://github.com/micromata/baumeister/issues",
    "initialVersion": "1.0.0",
    "addDistToVersionControl": false
  }
}
```

See the [Features of this generator](#features-of-this-generator).

### Getting To Know Yeoman

Yeoman has a heart of gold. He's a person with feelings and opinions, but he's very easy to work with. If you think he's too opinionated, he can be easily convinced.

If you'd like to get to know Yeoman better, check out the complete [Getting Started Guide](https://github.com/yeoman/yeoman/wiki/Getting-Started).


## Contributing to this project

Anyone and everyone is welcome to contribute. Please take a moment to
review our [Code of Conduct](CODE_OF_CONDUCT.md) as well as our [guidelines for contributing](CONTRIBUTING.md).

* [Bug reports](CONTRIBUTING.md#bugs)
* [Feature requests](CONTRIBUTING.md#features)
* [Pull requests](CONTRIBUTING.md#pull-requests)

## License

Please be aware of the licenses of the components we use in this project.
Everything else that has been developed by the contributions to this project is under [MIT License](LICENSE).

---
_Source: https://npm.io/package/generator-baumeister · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
