{"id":13394344,"url":"https://github.com/halfzebra/create-elm-app","last_synced_at":"2025-05-13T21:06:08.724Z","repository":{"id":10918873,"uuid":"67362231","full_name":"halfzebra/create-elm-app","owner":"halfzebra","description":" 🍃 Create Elm apps with zero configuration","archived":false,"fork":false,"pushed_at":"2025-05-06T15:38:03.000Z","size":1608,"stargazers_count":1686,"open_issues_count":52,"forks_count":147,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-05-06T16:51:35.820Z","etag":null,"topics":["boilerplate","build-tool","cli","elm","elm-platform","hmr","scaffolding","webpack","zero-configuration"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/halfzebra.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2016-09-04T18:44:08.000Z","updated_at":"2025-03-31T18:01:17.000Z","dependencies_parsed_at":"2023-10-15T02:46:46.581Z","dependency_job_id":"2c3a772a-c13b-47c0-98de-482ef7078440","html_url":"https://github.com/halfzebra/create-elm-app","commit_stats":{"total_commits":636,"total_committers":87,"mean_commits":7.310344827586207,"dds":0.6556603773584906,"last_synced_commit":"efcb696b0f2033bef503f4f5df90fbb76e13b63e"},"previous_names":[],"tags_count":151,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halfzebra%2Fcreate-elm-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halfzebra%2Fcreate-elm-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halfzebra%2Fcreate-elm-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halfzebra%2Fcreate-elm-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/halfzebra","download_url":"https://codeload.github.com/halfzebra/create-elm-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254028721,"owners_count":22002277,"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","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":["boilerplate","build-tool","cli","elm","elm-platform","hmr","scaffolding","webpack","zero-configuration"],"created_at":"2024-07-30T17:01:16.548Z","updated_at":"2025-05-13T21:06:08.678Z","avatar_url":"https://github.com/halfzebra.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","cli","Boilerplates","Web"],"sub_categories":["Individual Podcast episodes"],"readme":"# Create Elm App [![npm version](https://badge.fury.io/js/create-elm-app.svg)](https://badge.fury.io/js/create-elm-app) [![Build Status](https://travis-ci.org/halfzebra/create-elm-app.svg?branch=tests)](https://travis-ci.org/halfzebra/create-elm-app) [![Build Status](https://ci.appveyor.com/api/projects/status/github/halfzebra/create-elm-app?branch=master\u0026svg=true)](https://ci.appveyor.com/project/halfzebra/create-elm-app)\n\nCreate Elm apps with no build configuration.\n\n* [Getting Started](#getting-started) – How to create a new app.\n* [User Guide](https://github.com/halfzebra/create-elm-app/blob/master/template/README.md) – How to develop apps bootstrapped with Create Elm App.\n* [Elm SPA example](https://github.com/halfzebra/elm-spa-example) - Using Create Elm App Elm in SPA example by [Richard Feldman.](https://github.com/rtfeldman)\n\n## Quickstart\n\n```sh\nnpm install create-elm-app -g\ncreate-elm-app my-app\ncd my-app/\nelm-app start\n```\n\nCreate a production build with `elm-app build`\n\n## Getting Started\n\n### Installation\n\n**Node \u003e=8** is required for installation.\n\n#### Yarn\n\n`yarn global add create-elm-app`\n\n#### NPM\n`npm install create-elm-app -g`\n\nIf you are running Linux OS, you should install it as the superuser:\n\n`sudo npm install create-elm-app -g`\n\n### Creating an App\n\nTo create a new app, run:\n\n```sh\ncreate-elm-app my-app\ncd my-app/\n```\n\n![create-elm-app](https://cloud.githubusercontent.com/assets/3983879/18608348/157f6532-7ce7-11e6-9739-a09f44ae9644.png)\n\nCreate a new `my-app` folder with files for your future project.\n\n```\nmy-app/\n├── .gitignore\n├── README.md\n├── elm.json\n├── elm-stuff\n├── public\n│   ├── favicon.ico\n│   ├── index.html\n│   ├── logo.svg\n│   └── manifest.json\n├── src\n│   ├── Main.elm\n│   ├── index.js\n│   ├── main.css\n│   └── serviceWorker.js\n└── tests\n    └── Tests.elm\n```\n\nYou are ready to employ the full power of Create Elm App!\n\n### `elm-app start`\nRun the app in development mode.\nOpen [http://localhost:3000](http://localhost:3000) to view it in the browser.\n\n![elm-app-start](https://cloud.githubusercontent.com/assets/3983879/18608347/157e88ec-7ce7-11e6-8924-a046a95f6381.png)\n\nThe page will reload if you make edits.\nYou will see the build errors and lint warnings in the console and the browser window.\n\n### `elm-app build`\nBuilds the app for production to the `build` folder.\nIt bundles Elm app and optimizes the build for the best performance.\n\nThe build is minified, and the filenames include the hashes.\n\n## Guide\nEvery generated project will contain a readme with guidelines for future development.\nThe latest version is available [here](https://github.com/halfzebra/create-elm-app/blob/master/template/README.md)\n\n## Why use this?\nDeveloping with Elm is fun and easy, but at some point, you will hit a couple of limitations.\n\n- [elm-make](https://guide.elm-lang.org/install.html#elm-make) has a limited support for working with JavaScript and CSS.\n- [elm-reactor](https://guide.elm-lang.org/install.html#elm-reactor) does not work with apps that rely on [ports.](http://guide.elm-lang.org/interop/javascript.html)\n- You can not use [Hot Module Replacement.](https://webpack.js.org/concepts/hot-module-replacement)\n\nCreate Elm App adds a tool for optimizing production builds and running a development server with your app, which supports HMR.\n\nAll of that, combined with all the functionality of [elm](https://guide.elm-lang.org/install.html) in a single command line tool, which you might use as a dependency or `eject` anytime.\n\n## Want a custom setup?\n\nNot happy with the default configuration? Use `elm-app eject` and customize your process.\n\nThat way, you can use Create Elm App as a tool for a boilerplate generation.\n\n## Philosophy\n\nInspired by [create-react-app](https://github.com/facebookincubator/create-react-app)\n\n* **One Dependency:** There is just one build dependency. It uses  Elm Platform, Webpack, and other amazing projects, but provides a cohesive curated experience on top of them.\n\n* **Zero Configuration:** No configuration files or command line options required to start working with Elm. Configuring both development and production builds is handled for you so you can focus on writing code.\n\n* **No Lock-In:** You can “eject” to a custom setup at any time. Run a single command, and all the configuration and build dependencies will be moved directly into your project, so you can pick up right where you left off.\n\n## What is inside\n\nThe tools used by Create Elm App are subject to change.\nCurrently it is a thin layer on top of many amazing community projects, such as:\n\n* [elm](https://github.com/elm/compiler/tree/master/installers/npm)\n* [elm-test](https://github.com/elm-community/elm-test)\n* [webpack](https://webpack.js.org/) with [webpack-dev-server](https://github.com/webpack/webpack-dev-server), [html-webpack-plugin](https://github.com/ampedandwired/html-webpack-plugin) and [style-loader](https://github.com/webpack/style-loader)\n* [Babel](http://babeljs.io/) with ES6\n* [Autoprefixer](https://github.com/postcss/autoprefixer)\n* and others.\n\nAll of them are transitive dependencies of the provided npm package.\n\n## Contributing\n\nWe would love to get you involved! Please check our [Contributing Guide](CONTRIBUTING.md) to get started!\n\n## Alternatives\n\n- [parcel](http://blog.hercules-ci.com/elm/2018/11/21/using-elm-and-parcel-for-zero-configuration-web-asset-management/)\n- [elm-webpack-starter](https://github.com/elm-community/elm-webpack-starter)\n- [spades](https://github.com/rogeriochaves/spades)\n- [elm-live](https://github.com/tomekwi/elm-live)\n- [elm-app-boilerplate](https://github.com/gkubisa/elm-app-boilerplate)\n- [elm-hot-loader-starter](https://github.com/klazuka/example-elm-hot-webpack)\n- [generator-elm](https://github.com/danneu/generator-elm)\n- [elm-boil](https://github.com/GioPat/elm-boil)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalfzebra%2Fcreate-elm-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhalfzebra%2Fcreate-elm-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalfzebra%2Fcreate-elm-app/lists"}