weseek__growi

crowi-plus

This is crowi-plus that is the fork of Crowi, is perfectly compatible with official, and has been enhanced with the following points:

• Pluggable
  • Find plugins from npm or github!
• Faster
  • Optimize client-side code chunks by Webpack
  • Using CDN
• Secure
  • Upgrade jQuery to 3.x
  • Upgrade other insecure libs
• Docker Ready
• Docker Compose Ready
• Added miscellaneous features
• Developer-friendly
  • Less compile time
  • LiveReload separately available by server/client code change
  • Exclude Environment-dependency (confirmed to be developable on Win/Mac/Linux)
    

Quick Start for Production

Using Heroku

1. go to https://heroku.com/deploy
2. input INSTALL_PLUGINS to install plugins

Using docker-compose

git clone https://github.com/weseek/crowi-plus-docker-compose.git crowi-plus
cd crowi-plus
docker-compose up

see also weseek/crowi-plus-docker-compose

On-premise

Dependencies

• node 6.x (DON'T USE 7.x)
• npm 4.x
• yarn

Start

git clone https://github.com/weseek/crowi-plus.git
cd crowi-plus
yarn
MONGO_URI=mongodb://example.com/crowi npm start

Install plugins

• Stop server if running
• npm install --save to install plugin or yarn add
  • Don't forget --save option if you use npm or crowi-plus doesn't detect plugins
• npm start to build client app and start server

Example

yarn add crowi-plugin-lsx
npm start

Other documents

More info are here.

Getting Started to Develop

Dependencies

• node 6.x (DON'T USE 7.x)
• npm 4.x

• yarn

• following environment is confirmed to work

  $ node -v
  v6.10.0
      
  $ npm -v
  4.5.0
      
  $ yarn --version
  0.21.3
  

Build and Running the app

• clone this repository
• npm install -g npm@4 to install required global dependencies
• npm install to install all dependencies or yarn
• npm run build to build client app
• npm run server to start the dev server in another tab

After you have installed all dependencies and build client you can now run the app. Run npm run server to start a local server using node-dev which will watch server-side codes and reload for you. The port will be displayed to you as http://0.0.0.0:3000.

build and run server

# development
npm run build
npm run server
# production
npm run build:prod
npm run server:prod

Other commands

build client app

# development
npm run build:dev
# production
npm run build:prod

watch client-side codes and incremental build

npm run build:dev:watch

run unit tests

npm test

Documentation

• github wiki pages
  • Questions and Answers

Contributing

(TBD)

License

• The MIT License (MIT)
• See LICENSE file.