# create-vanilla-app

> Create Vanilla App allows you to develop vanilla javascript projects from scratch with support to Webcomponents and Typescript

Latest version **1.1.5** (published 2019-11-03) · MIT license · 0 weekly downloads

## Install

```sh
npm install create-vanilla-app
pnpm add create-vanilla-app
yarn add create-vanilla-app
bun add create-vanilla-app
```

Provides the command `create-vanilla-app`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.5 |
| Published | 2019-11-03 |
| First published | 2019-11-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 9 |
| Unpacked size | 17.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Gabriel Mayta |
| Maintainers | grandemayta |
| Keywords | webcomponents, customelements, vanillaJS, typescript |

## Links

- npm: https://www.npmjs.com/package/create-vanilla-app
- Repository: https://github.com/grandemayta/create-vanilla-app
- Homepage: https://github.com/grandemayta/create-vanilla-app#readme
- Issues: https://github.com/grandemayta/create-vanilla-app/issues
- npm.io page: https://npm.io/package/create-vanilla-app

## Dependencies (9)

- [npm](https://npm.io/package/npm.md) ^6.9.0
- [path](https://npm.io/package/path.md) ^0.12.7
- [yarn](https://npm.io/package/yarn.md) ^1.17.3
- [chalk](https://npm.io/package/chalk.md) ^2.4.2
- [clear](https://npm.io/package/clear.md) ^0.1.0
- [figlet](https://npm.io/package/figlet.md) ^1.2.3
- [mem-fs](https://npm.io/package/mem-fs.md) ^1.1.3
- [inquirer](https://npm.io/package/inquirer.md) ^6.3.1
- [mem-fs-editor](https://npm.io/package/mem-fs-editor.md) ^6.0.0

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 1.1.5 (latest) — 2019-11-03
- 1.1.4 — 2019-11-03
- 1.1.3 — 2019-11-03
- 1.1.2 — 2019-11-03
- 1.1.1 — 2019-11-03
- 1.1.0 — 2019-11-03
- 1.0.0 — 2019-11-03

## README

# Create Vanilla App 🔧📦
[![Open Source Love](https://badges.frapsoft.com/os/mit/mit.svg?v=102)](https://github.com/ellerbrock/open-source-badge/)
[![made-with-javascript-doc](https://img.shields.io/badge/Made%20with-Javascript-1f425f.svg)](https://www.sphinx-doc.org/)

Create Vanilla App allows you to develop vanilla javascript projects from scratch with support to Webcomponents, Sass and Typescript.

## Summary
- [Installation](#install)
- [Create a project](#create-a-project)
- [Getting started](#getting-started)
- [Scripts availables](#scripts)
- [Integration](#integration)
    - [Build for modern browsers](#build-for-modern-browsers)
    - [Build with support for legacy browsers](#build-with-support-for-legacy-browsers)
    - [Html example](#html-example)
- [Polyfills](#polyfills)
- [Browsers support](#browsers-support)
- [Todo](#todo)

## Install

```sh
npm install -g create-vanilla-app
```

## Create a Project

```sh
create-vanilla-app <name-of-your-project>
```

## Getting Started
Launch the following commands to start the application:

```sh
npm start
```

## Scripts:

| Command | Description |
| ------ | ------ |
| npm start | Lift the application in local mode |
| npm run dev | Generate a build in dev mode |
| npm run prod | Generate a build in prod mode |
| npm run dev:legacy | Generate a build in dev mode to support legacy browsers |
| npm run prod:legacy | Generate a build in prod mode to support legacy browsers |

## Integration
Build tasks will create the following output:

#### Build for modern browsers:

    ├── dist/
        ├── styles.min.css
        ├── bundle.min.js

#### Build with support for legacy browsers:

    ├── dist/
        ├── styles.min.css
        ├── bundle.min.js
        ├── polyfills.min.js
        ├── webcomponents-loader.js
        ├── bundles/                               # These scripts will load at runtime
            ├── webcomponents-ce.js
            ├── webcomponents-sd-ce-pf.js
            ├── webcomponents-sd-ce.js
            ├── webcomponents-sd.js

#### Html example:

```html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Create Vanilla App Example Integration</title>
    <link rel="stylesheet" href="styles.css">
</head>
<body>

    <app-greetings fullname="Charlotte"></app-greetings>

    <!-- If you want support legacy browser just remove this comment
    <script src="polyfills.min.js" nomodule></script>
    <script src="webcomponents-loader.js"></script>
    -->
    <script src="bundle.min.js"></script>
</body>
</html>
```

## Polyfills
We support the following features:

- Generics
    - Symbol
    - fetch
    - Promise
    - Async / Await

- Arrays
    - entries
    - from
    - find
    - findIndex
    - includes
    - keys
    - values

- Objects
    - assign
    - entries
    - values

- Strings
    - endsWith
    - includes
    - startsWith

## Browsers support

:white_check_mark: Chrome
<br/>
:white_check_mark: Firefox
<br/>
:white_check_mark: Safari
<br/>
:white_check_mark: Edge
<br/>
:white_check_mark: IE11

```sh
npm run prod
```

## Todo

- [ ] Setup Unit Testing
- [ ] Setup E2E Testing

Keep calm and code!
<br>
[![Open Source Love](https://badges.frapsoft.com/os/v3/open-source.svg?v=102)](https://github.com/ellerbrock/open-source-badge/)

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