create-evergreen-app

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #golang #machine-learning #deep-learning #linux #nodejs #java #cli #kubernetes #awesome-list #ios

create-evergreen-app

(★ 17)

Get up and running with an evergreen web application development stack designed by, and for, today's modern web.

create-evergreen-app 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# create-evergreen-app
[![GitHub release](https://img.shields.io/github/tag/ProjectEvergreen/create-evergreen-app.svg)](https://github.com/ProjectEvergreen/create-evergreen-app/tags)
![CircleCI branch](https://img.shields.io/circleci/project/github/ProjectEvergreen/create-evergreen-app/master.svg?style=plastic)
[![GitHub issues](https://img.shields.io/github/issues-raw/ProjectEvergreen/create-evergreen-app.svg)](https://github.com/ProjectEvergreen/create-evergreen-app/issues)
[![GitHub issues](https://img.shields.io/github/issues-pr-raw/ProjectEvergreen/create-evergreen-app.svg)](https://github.com/ProjectEvergreen/create-evergreen-app/issues)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/ProjectEvergreen/create-evergreen-app/master/LICENSE.md)

> ⛔ _**Attention**_
> _This project has been archived and is no longer under active maintenance.  If you are looking for a great tool for building websites and apps, please join us with our latest project [**Greenwood**](https://www.greenwoodjs.io/)!_ 🌟

## Overview
A starter project for getting up and running with an evergreen web application development stack designed by, and for, today's modern web.
![Create Evergreen App](https://s3.amazonaws.com/uploads.thegreenhouse.io/project-evergreen/create-evergreen-app-github-repo-banner-0.4.0.png)

### Project Goals
The goal of Project Evergreen is to march alongside the web and demonstrate those features in projects like these, that can be a reference and starting point, so that both developers and users can benefit from a modern application intended for modern browsers.  Evergreen Web Applications aim to be performant, promote usage of modern web features, be accessible to a wide range of users, and be a productive experience for developers.

## Getting Started
Make sure you have a LTS version of [Node.js](https://nodejs.org/) (>= 10.x) and then follow these steps to get up and running:
```shell
# 1) Create new evergreen app
$ npx create-evergreen-app my-app

# 2) Change Directory
$ cd my-app

# 3) Start developing!
$ npm start

# or

$ yarn start
```

You can also run the installer locally by cloning the repo and using NodeJS
```shell
$ git clone https://github.com/ProjectEvergreen/create-evergreen-app.git
$ cd create-evergreen-app
$ npm ci # install project dependencies
$ node ./tasks/cea-install.js my-app # you can pass other supported CLI params here as well
$ mv my-app /where/ever/you/want # move my-app folder anywhere you want, and start developing!
```

### Additional CLI Commands
Here are some additional commands you can use when running the installer
```shell
# install dependencies with Yarn instead of npm
$ npx create-evergreen-app my-app --yarn

# get help
$ npx create-evergreen-app --help

# get the version
$ npx create-evergreen-app --version
```

## Developing with Create Evergreen App
To start developing, simply open the _my-app_ folder in your favorite IDE ([VSCode](https://code.visualstudio.com/) has great modern JavaScript support) and start editing  and adding files as you need in `src/`.

### Development Workflows
Automated tasks have been made available as **npm** scripts that you can run from the command line using `yarn` or `npm run`:
- `develop` - To start a development server with live reload and file watching
- `build` - Generate a production build of the app for deployment
- `serve` - Locally serve a production build
- `test` - Run unit tests in TDD mode (prepend with `NODE_ENV=production` for "single run" usage)
- `start` - alias to the `develop` task

e.g. to start developing, run
```shell
# yarn
$ yarn develop

or

# npm
$ npm run develop
```

### Package Management
Your team may choose to use either **npm** or **Yarn**, just make sure to pick one and remove the other manager's lock file.  Make sure to update the lock file whenever adding / removing a package.

### Guides
These are some guides related to configuring different parts of this application to customize it for your needs.

#### Folder Structure
There is no right or wrong folder structure per se as with most decisions relating to technology, it's about finding the best tool for the job.  Pick the conventions that fit your team / project best.

That said, CEA does come with with a lightly opinionated structure in the _src/_ directory as one of the main goals of a good folder structure should be to assist in the finding of  files / code faster and being predicatable.  Here is some info on the approach presented / suggested in this repo:
- _index.js_ - Main Entry point into the application (defined in _webpack.config.common.js_)
- _index.html_ - Defines the HTML "shell" of the application.
- _app/_ - The top level "app" component, that will be used to bootstrap the application.
- _components/_ - Essentially all the custom elements for an app will go here, encapsulating all reusable UI logic.
- _pages/_ - Routable states and / or views that users will navigate to within an application.
- _services/_ - Utilities for making (RESTful) API calls, convenience "wrappers" around browser APIs (Web Storage), etc.  These generally don't interact with the DOM (that's what components are for).

> Unit tests are recommended to be kept side by side with the component / `class` / etc.  For integration and E2E tests, consider making a _test/_ directory alongside the _src/_ directory and put those tests there.

#### Setting Up (API) Proxies
In _webpack.config.develop.js_ and _lws.config.js_ are sections for setting up proxies for routing requests, say to an API running in your development envrionment.  Edit the placeholders to match your particular needs.

#### CSS + Shadow DOM
// TODO

#### Performance
Performance is an important consideration for developing and maintaing any modern web application.  Out of the box, this project uses **webpack**'s [default settings for performance budgets](https://webpack.js.org/configuration/performance/) and will error when its thresholds are exceeded.

The goal of this project will be to support good code splitting and lazy loading strategies by default to allow apps to scale horizontally as more pages / features / dependencies get added.

To learn more about performance best practices for modern web application development, check out the [wiki](https://github.com/ProjectEvergreen/create-evergreen-app/wiki/Performance).

#### Unit Testing
For convenience, Create Evergreen App comes with the dependencies needed to run two browsers out of the box
1. Chrome (headless w/[Puppeteer](https://github.com/GoogleChrome/puppeteer/))
1. Firefox

**Using Firefox**
1. Firefox (and other browsers) will likely need Custom Elements and Shadow DOM polyfilled.  To add this polyfill in Karma, uncomment the lines in the `files` array in _karma.conf.js_ related to  `~@webcomponents`.
1. Add Firefox to the `browsers` array in _karma.conf.js_.

- For information on adding more browsers, see [the Karma docs](http://karma-runner.github.io/3.0/config/browsers.html).
- For more information on testing in general, see [our wiki!](https://github.com/ProjectEvergreen/create-evergreen-app/wiki).

> Chrome headless is enabled by default since it is the most portable between local and continuous integration environments.

## Acknowledgements
This project is made by possible with the much appreciated existence of tools like:
- [webpack](https://webpack.js.org/)
- [LitElement](https://github.com/Polymer/lit-element)
- [Babel](https://babeljs.io/)
- [PostCSS](https://github.com/postcss/postcss)
- [Browserslist](https://github.com/browserslist/browserslist)
- [WebComponents.org](https://www.webcomponents.org/)

And of course, nods and kudos go out to the maintainers of [Create React App](https://github.com/facebook/create-react-app) (CRA) and Pascal Shlip (@thepassle) of [Create Lit App](https://github.com/thepassle/create-lit-app) for the inspiration.

Thank you, to all of you!

create-evergreen-app

create-evergreen-app 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

create-evergreen-app

create-evergreen-app 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README