Skip to content

Commit

Permalink
Improve frontend README
Browse files Browse the repository at this point in the history
  • Loading branch information
adrianhuna committed Sep 19, 2016
1 parent 896eac0 commit 6b71952
Show file tree
Hide file tree
Showing 3 changed files with 37 additions and 6 deletions.
35 changes: 34 additions & 1 deletion frontend/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,37 @@
# PHPCity frontend
This is frontend part of [PHPCity](https://github.com/adrianhuna/PHPCity) visualization. Visit [visualization application](https://adrianhuna.github.io/PHPCity) to see it in action. Instructions for visualizing your projects can be found in [backend part](https://github.com/adrianhuna/PHPCity/tree/master/backend) of this project.

To read more about this project see README in [root directory](https://github.com/adrianhuna/PHPCity/blob/master/README.md).
To read more about this project see README in [root directory](https://github.com/adrianhuna/PHPCity/blob/master/README.md).

## Development
This project is written in Typescript. If you need to edit something, please proceed as follows:
- move into `frontend` folder of [PHPCity](https://github.com/adrianhuna/PHPCity) if you are not already (`cd frontend`)
- run `npm install` to install development libraries
- run `bower install` to install project's dependencies
- run `gulp` to start building process
- open `dist/index.html` in your browser
- edit files as needed - changes will be detected and reflected automatically

Gulp task `gulp build:dist` is designed to be used when creating a new release.

## Libraries used
#### [three.js](http://threejs.org/)
- WebGL 3D library

#### [bin-packing](https://github.com/jakesgordon/bin-packing)
- optimal positioning of buildings in the city

#### [d3](https://d3js.org/)
- for histogram visualization

#### [stats.js](https://github.com/mrdoob/stats.js/)
- JavaScript performance monitor

#### OrbitControls](http://threejs.org/examples/js/controls/OrbitControls.js)
- orbiting controls that allow zooming and panning

#### Well known
- [jquery](https://jquery.com/)
- [bootstrap](http://getbootstrap.com/)
- [underscore](http://underscorejs.org/)
- [font-awesome](http://fontawesome.io/)
2 changes: 1 addition & 1 deletion frontend/bower.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"structure",
"three.js"
],
"homepage": "",
"homepage": "https://github.com/adrianhuna/PHPCity",
"ignore": [
"**/.*",
"node_modules",
Expand Down
6 changes: 2 additions & 4 deletions frontend/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
},
"repository": {
"type": "git",
"url": "github.com/adrianhuna/PhpCity"
"url": "https://github.com/adrianhuna/PHPCity"
},
"keywords": [
"visualization",
Expand All @@ -21,6 +21,7 @@
"author": "Adrian Huna",
"license": "MIT",
"devDependencies": {
"del": "^2.2.2",
"browserify": "^13.1.0",
"gulp": "^3.9.1",
"gulp-clean-css": "^2.0.12",
Expand All @@ -41,8 +42,5 @@
"vinyl-buffer": "^1.0.0",
"vinyl-source-stream": "^1.1.0",
"watchify": "^3.7.0"
},
"dependencies": {
"del": "^2.2.2"
}
}

0 comments on commit 6b71952

Please sign in to comment.