Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/elm-community/elm-webpack-starter

Boilerplate for developing Elm apps on Webpack
https://github.com/elm-community/elm-webpack-starter

elm webpack

Last synced: 2 months ago
JSON representation

Boilerplate for developing Elm apps on Webpack

Host: GitHub
URL: https://github.com/elm-community/elm-webpack-starter
Owner: elm-community
Created: 2015-12-31T19:32:20.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2021-12-12T20:40:22.000Z (over 2 years ago)
Last Synced: 2024-04-18T14:45:26.444Z (2 months ago)
Topics: elm, webpack
Language: JavaScript
Homepage: http://elm-community.org/elm-webpack-starter/
Size: 486 KB
Stars: 862
Watchers: 16
Forks: 115
Open Issues: 10
Metadata Files:
- Readme: README.md

Lists

awesome-elm - elm-webpack-starter - A simple Webpack setup for writing Elm apps. (Boilerplates / Outdated Boilerplates)
awesome-github-repos - elm-community/elm-webpack-starter - Boilerplate for developing Elm apps on Webpack (JavaScript)
awesome-stars - elm-community/elm-webpack-starter - Boilerplate for developing Elm apps on Webpack (JavaScript)
awesome-stars - elm-webpack-starter - community | 872 | (JavaScript)

README

# elm-webpack-starter

### About:
A simple Webpack setup for writing [Elm](http://elm-lang.org/) apps:

* Dev server with live reloading, HMR
* Support for CSS/SCSS (with Autoprefixer), image assets
* Bootstrap 3.3+ (Sass version)
* Bundling and minification for deployment
* Basic app scaffold, using `Html.beginnerProgram`
* A snippet of example code to get you started!

### Install:
Clone this repo into a new project folder, e.g. `my-elm-project`:
```
git clone https://github.com/moarwick/elm-webpack-starter my-elm-project
cd my-elm-project
```

Re-initialize the project folder as your own repo:
```
rm -rf .git # on Windows: rmdir .git /s /q
git init
git add .
git commit -m 'first commit'
```

Install all dependencies using the handy `reinstall` script:
```
npm run reinstall
```
*This does a clean (re)install of all npm and elm packages, plus a global elm install.*

### Serve locally:
```
npm start
```
* Access app at `http://localhost:8080/`
* Get coding! The entry point file is `src/elm/Main.elm`
* Browser will refresh automatically on any file changes..

### Build & bundle for prod:
```
npm run build
```

* Files are saved into the `/dist` folder
* To check it, open `dist/index.html`

### Changelog

**Ver 0.8.6**
* Update Packages (-> Webpack 2)
* fix paths in file-loader
* clean up build script

**Ver 0.8.5**
* Fix loading path of generated js file, per [Issue 47](https://github.com/moarwick/elm-webpack-starter/issues/47)

**Ver 0.8.4**
* Fix hot reloading of components, per [Issue 44](https://github.com/moarwick/elm-webpack-starter/issues/44)

**Ver 0.8.3**
* Update packages
* Attempt to fix path issues when building for prod (temp)

**Ver 0.8.2**
* Webpack config improvements (PR by [Lesuk](https://github.com/moarwick/elm-webpack-starter/pull/39))

**Ver 0.8.0**
* Update to Elm 0.18, use `debug=true` on webpack loader (PR by [douglascorrea](https://github.com/moarwick/elm-webpack-starter/pull/33))
* Add a script for one-step installs
* Update to latest packages

**Ver 0.7.1**
* Fix favicon issues, per [Issue 30](https://github.com/moarwick/elm-webpack-starter/issues/30)

**Ver 0.7.0**
* Modify project structure, per [Issue 26](https://github.com/moarwick/elm-webpack-starter/issues/26)
* Include Bootstrap JS, per [Issue 28](https://github.com/moarwick/elm-webpack-starter/issues/28)
* More helpful install steps in README, per [Issue 29](https://github.com/moarwick/elm-webpack-starter/issues/29)
* Update to latest packages

**Ver 0.6.2**
* Use `copy-webpack-plugin` instead of `cp` to copy files (Windows compatible)

**Ver 0.6.0**
* `elm-hot-loader` is back (no Elm code changes required!)
* Switch to [bootstrap-sass](https://www.npmjs.com/package/bootstrap-sass) to demo CSS

**Ver 0.5.0**
* Update to Elm 0.17.0 (and other latest modules)
* Upgrade starter code per [upgrade-docs](https://github.com/elm-lang/elm-platform/blob/master/upgrade-docs/0.17.md)
* Remove `elm-hot-loader` (for now)

**Ver 0.4.0**
* Add [elm-hot-loader](https://github.com/fluxxu/elm-hot-loader) for HMR support (PR by [fluxxu](https://github.com/fluxxu))

**Ver 0.3.0**
* Use `html-webpack-plugin` to generate `index.html`
* Apply hash filenames for bundled JS and CSS (prevents caching)
* Image and favicon assets copied to `dist/`