Diffy - A tool for sharing diff output online
How to contribute
Diffy is a Node.js application. Appart from Node.js, the only other thing you'll need is mongodb. To get you started these are the steps:
- Install Node.js and NPM
- Install MongoDB and make it listen on localhost with default port
- Clone the repo:
git clone https://github.com/pbu88/diffy.git
- Install and build frontend code (AngularJS app)
cd diffy/frontend
npm install
ng build
- Install and build backend code (Typescript)
cd diff/backend/
npm install
npm run build
npm test
- Run it:
DIFFY_GA_ANALYTICS_KEY=none npm run v2_start
Docker
If you want to run Diffy using Docker, you don't need to follow any of the above manual steps:
- Install docker and docker-compose
- Run the tests:
docker-compose run web npm test
- Launch diffy:
docker-compose up
The mongodb data will be stored on the data/
folder.
That should get you with a basic working dev environment. Now, go ahead and fill your pull request :)
Also, feel free to create an issue if you find a bug or if something isn't working as expected when setting up the development environment.