Skip to content

Core developer stack for JavaScript applications with server side rendering, code splitting, webpack 3

Notifications You must be signed in to change notification settings

blueberryapps/haystack

Repository files navigation

Haystack

Haystack CircleCI Dependency Status

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 <Script src="https://cdn.polyfill.io/v2/polyfill.min.js?features=Symbol" />.

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

Future toggles

When you need to use feature toggles you can use them like this:

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

About

Core developer stack for JavaScript applications with server side rendering, code splitting, webpack 3

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published