Giter VIP home page Giter VIP logo

crowi-plus's Introduction

Crowi

Demo Site

crowi-plus Chat on Slack

wercker status dependencies status devDependencies Status docker pulls MIT License

crowi-plus is a fork of Crowi that is perfectly compatible with the official project.

Why crowi-plus?

Check it out all additional features from here.

Quick Start for Production

Using Heroku

  1. Go to https://heroku.com/deploy
  2. (Optional) 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

Migration Guide from Official Crowi is here.

Dependencies

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

See confirmed versions.

Optional Dependencies

Start

Build and run the app

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

DON'T USE npm install, use yarn instead.

If you launch crowi-plus with Redis and ElasticSearch, add environment variables before npm start like following:

export MONGO_URI=mongodb://MONGO_HOST:MONGO_PORT/crowi
export REDIS_URL=redis://REDIS_HOST:REDIS_PORT/crowi
export ELASTICSEARCH_URI=http://ELASTICSEARCH_HOST:ELASTICSEARCH_PORT/crowi
npm start

For more info, check Developers Guide and the official documents.

Command details

command desc
npm run build:prod Build the client
npm run server:prod Launch the server
npm start Invoke npm run build:prod and npm run server:prod

Upgrade

git pull
yarn
npm start

Install plugins

  • Stop server if running
  • yarn add to install plugin or npm install --save
    • 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

Getting Started to Develop

Build and Run the app

  1. clone this repository
  2. yarn global add npm@4 to install required global dependencies
  3. yarn to install all dependencies
    • DON'T USE npm install
  4. npm run build to build client app
  5. npm run server to start the dev server
  6. Access to http://0.0.0.0:3000

For more info, read Developers Guide on Wiki.

Documentation

Contributing

Found a Bug?

If you find a bug in the source code, you can help us by submitting an issue to our GitHub Repository. Even better, you can submit a Pull Request with a fix.

Missing a Feature?

You can request a new feature by submitting an issue to our GitHub Repository. If you would like to implement a new feature, please submit an issue with a proposal for your work first, to be sure that we can use it. Please consider what kind of change it is:

  • For a Major Feature, first open an issue and outline your proposal so that it can be discussed. This will also allow us to better coordinate our efforts, prevent duplication of work, and help you to craft the change so that it is successfully accepted into the project.
  • Small Features can be crafted and directly submitted as a Pull Request.

Language

Write issues and PRs in English or Japanese.

Discussion

If you have something to ask or want to discuss, join to our Slack team and talk about anything, anytime.

License

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

crowi-plus's People

Contributors

yuki-takei avatar sotarok avatar suzuki avatar tatsuyaise avatar ryu-sato avatar riaf avatar hiroppy avatar babarot avatar hideo54 avatar angola avatar fivestar avatar syenze avatar nukosuke avatar dascarlet avatar kaz avatar yudoufu avatar xcezx avatar takahashim avatar tkitsunai avatar ta2yak avatar crow-misia avatar yuya-takeyama avatar watagashi avatar gitter-badger avatar chuganzy avatar ryo33 avatar kdmsnr avatar kouki-o avatar tomasom avatar aximov avatar

Watchers

James Cloos avatar a4t avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.