Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blueberryapps/haystack
Core developer stack for JavaScript applications with server side rendering, code splitting, webpack 3
https://github.com/blueberryapps/haystack
blueberry-opensource bolierplate express react react-native redux router server-side-rendering
Last synced: 3 months ago
JSON representation
Core developer stack for JavaScript applications with server side rendering, code splitting, webpack 3
- Host: GitHub
- URL: https://github.com/blueberryapps/haystack
- Owner: blueberryapps
- Created: 2017-01-13T13:35:13.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-24T17:54:33.000Z (almost 2 years ago)
- Last Synced: 2024-04-09T21:49:10.431Z (10 months ago)
- Topics: blueberry-opensource, bolierplate, express, react, react-native, redux, router, server-side-rendering
- Language: JavaScript
- Homepage:
- Size: 12.9 MB
- Stars: 16
- Watchers: 31
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Haystack [](https://circleci.com/gh/blueberryapps/haystack/tree/master) [](https://dependencyci.com/github/blueberryapps/haystack)
> Blueberry JS Stack
## Create brand new app by:
```
bash <(curl https://raw.githubusercontent.com/blueberryapps/haystack/master/create-haystack-app) NEW_PROJECT_NAME
```
## Scripts
- install dependencies: `yarn`
- start app: `yarn start`
- build app: `yarn build`
- test app: `yarn test`
## Development
```
yarn start
open https://localhost:8000
```
## Production Build
- production build: `yarn production:build`
- production server: `yarn production:server`
- production build and server: `yarn run production`
## Polyfills
We are using polyfills from www.polyfill.io and to add new polyfill go to
`src/server/frontend/Html.react.js` and update this line
``.
## Configuration
You can set ENV variables from `.bash_profile`, `export NODE_ENV=production`, running them inline `NODE_ENV=production yarn start` or use `.env` file in project root.
| env | values | default | meaning |
|-----|--------|---------|---------|
| NODE_ENV | development, production | development | development - hot reload, production - compiled & minified code |
| APP_ENV | development, staging, production | development | env for APP where it runs |
| PORT | number | 8000 | which port to use to run server side express App |
| HTML_ERRORS | true | enabled by default in production | Show nicely formatted html errors for 404 and 500 |
| ROLLBAR_CLIENT_TOKEN | string | default project in rollbar | token for browser error reporting |
| ROLLBAR_SERVER_TOKEN | string | default project in rollbar | token for server error reporting |
| GTM_ID | string | null | add this to enable Google Tag Manager |
| DEBUG_BUNDLE | boolean | false | show webpack BundleAnalyzer |
| ENABLE_SEARCH_BOTS | boolean | false | for production enable this so your page will be indexed by search bots |
| FEATURES | string | '' | add comma separated values with names of features |
| | | | |
## Variants
* [with basic redux](https://github.com/blueberryapps/haystack/tree/redux)
* [with basic router](https://github.com/blueberryapps/haystack/tree/router)
* [with redux + router](https://github.com/blueberryapps/haystack/tree/redux-router)
## Future toggles
When you need to use feature toggles you can use them like this:
```javascript
import isFeatureOn from '../common/featureToggl';
isFeatureOn('nameOfFeature'); // returns true/false based on FEATURES enabled
```
Naming of features `snakeCase`.
How to enable feature:
`FEATURES=featureA,featureB yarn start`
Or add feature to cookie named `FEATURES` with value: `featureA,featureB`
**! Be aware that enabling FEATURES by Cookie will not work with server side rendering and it is not a bug !**
## Made with love by
[](https://www.blueberry.io)