palo-express
v0.1.1
Published
Palo Framework
Downloads
14
Maintainers
Readme
Palo -- ES6-powered Express + React + Webpack + Jade
All modern technologies in one bundle: ECMAScript 6/7 via Babel + Express 4 + React + Webpack + FlightPlan + SASS + Redux + Jade
To run in dev mode, type npm run dev
or pm2 start pm2.local.json
to run in watch mode.
To build project, type npm run build
.
Installation
- Global dependencies:
npm i -g \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected] \
[email protected]
- Dependencies
npm i
Features
- ES6 + ES2015 via Babel + ESlint
- React + helmet
- SASS and LESS support
- Autobuild all with Webpack
- Automated deploy
- PM2 support
- Redux
- Jade support from-the-box
- Sprite build from images directory
- Remote repository data fetch and Model+Service architectute, so you can attach any another ORM like Sequelize
- Comfortable project structure:
├── app
│ ├── actions
│ │ ├── ...
│ │ └── // actions with redux
│ ├── client.jsx // client-side entry point
│ ├── components
│ │ ├── common // common react components
│ │ │ ├── authenticateComponent.jsx // predefined component wrapper to check authentication status
│ │ │ ├── ...
│ │ │ └── // other common components
│ │ ├── components // compoments like buttons etc.
│ │ │ ├── ...
│ │ │ └── // included component wrapper to check authentication status
│ │ └── pages
│ │ ├── ...
│ │ └── // page components which can be included as sub-components of routes in routes.jsx
│ ├── constants
│ │ ├── ...
│ │ ├── actionTypes.js // predefined action types for redux
│ │ └── // other constants
│ ├── createDevToolsWindow.js // script to show devtools with stack traces etc.
│ ├── elements
│ │ ├── ...
│ │ ├── Header.jsx // predefined script to render html head properly with helmet etc.
│ │ └── // other constants
│ ├── helmconfig.js // helmet config
│ ├── images
│ │ ├── favicon.png // base favicon
│ │ └── favicons
│ │ ├── apple-icon-152x152.png // apple touch icon
│ │ ├── chrome-icon-192x192.png // chrome icon
│ │ ├── favicon-16x16.png // basic favicon
│ │ ├── ms-icon-144x144.png // msie icon
│ │ ├── ...
│ │ └── // page components which can be included as sub-components of routes in routes.jsx
│ ├── reducers
│ │ ├── ...
│ │ ├── index.js // reducer loader
│ │ └── user.js // predefined user reducer
│ │ └── // other reducers
│ ├── routes.jsx // client-side router configuration
│ ├── scss // preferred SCSS structure is similar to components dir structure
│ │ ├── common
│ │ │ ├── helpers.scss
│ │ │ ├── main.scss
│ │ │ ├── mixins.scss
│ │ │ └── settings.scss
│ │ ├── components
│ │ │ ├── _layout.scss
│ │ │ ├── _login.scss
│ │ │ └── _logout.scss
│ │ ├── pages
│ │ │ └── _profile.scss
│ │ └── sprites
│ │ ├── ...
│ │ └── // generated sprite styles
│ ├── server.jsx // entry point to server-side rendeting script
│ ├── sprites
│ │ ├── ...
│ │ └── // generated sprite images
│ ├── store
│ │ └── configureStore.js
│ └── utils
│ ├── classnames.js
│ └── immutableHelpers.js
├── package.json
├── pm2.development.json // pm2 configuration in development mode
├── pm2.local.json // pm2 configuration in development mode with file watch
├── pm2.production.json // pm2 configuration in production mode
├── public
│ └── assets
│ │ ├── ...
│ │ └── // webpack generated output
├── runtime
│ └── logs
│ ├── stderr.log // application logs stdout output
│ └── stdout.log // application logs stderr output
├── server
│ ├── app.js // server entry point
│ ├── configuration
│ │ ├── config.js // server common configuration
│ │ ├── development.js // server enviroment-based configuration
│ │ ├── production.js // server enviroment-based configuration
│ │ └── local.js // server local configuration (unneccessary)
│ ├── controllers
│ │ ├── EntryPointController.js // predefined client-side html entry point generator
│ │ ├── ServerStatusController.js // server statuc controller (to show uptime, release version etc.)
│ │ ├── SessionController.js // login/logout etc.
│ │ ├── SingleUserController.js // single user controller
│ │ └── UserCollectionController.js // user collection controller
│ ├── core
│ │ ├── base
│ │ │ ├── Component.js
│ │ │ ├── Controller.js
│ │ │ ├── Exception.js
│ │ │ ├── Model.js
│ │ │ └── Service.js
│ │ ├── bootstrap.js
│ │ ├── components
│ │ │ ├── Pager.js
│ │ │ └── RemoteRequest.js
│ │ ├── constants
│ │ │ ├── index.js
│ │ │ └── paths.js // framework files locations, so to change where some files are placed you can set it here
│ │ ├── enumerations
│ │ │ ├── Environments.js
│ │ │ ├── HttpMethods.js
│ │ │ ├── PagerSortDirections.js
│ │ │ └── ServerParameters.js
│ │ ├── exceptions
│ │ │ ├── ComponentAutowireException.js
│ │ │ ├── CoreException.js
│ │ │ ├── HttpNotFoundException.js
│ │ │ ├── NotImplementedMethodException.js
│ │ │ └── SessionException.js
│ │ └── skeleton-config.js
│ ├── enumerations
│ │ └── pager
│ ├── exceptions
│ │ └── UserNotFoundException.js
│ ├── middlewares // predefined middlewares
│ │ ├── after
│ │ │ └── requestException.js
│ │ └── before
│ │ ├── jsonRequest.js
│ │ ├── passport.js
│ │ ├── pureSend.js
│ │ ├── requestTime.js
│ │ ├── safeRequest.js
│ │ ├── serveStatic.js
│ │ ├── session.js
│ │ ├── webpackDev.js
│ │ └── webpackHot.js
│ ├── models
│ │ └── User.js // predefined remote repository model
│ ├── runtime
│ ├── services
│ │ └── UserService.js // predefined user service
│ └── views
│ └── index.jade // client-side entry point html template
└── webpack
├── settings.js // webpack common environment-agnostic settings
├── webpack.config.development.js // webpack + hot reload config
└── webpack.config.production.js // webpack production config
TODO
- Implement Flightplan.js deployment script (restore) to deploy via
npm run deploy:target
ot viafly target
. - Refactor configuration (divide config declaration from data instantiation)
- Add support to load middleware from node_modules without compatibility wrapper