deanmoses / tacocat-gallery-react-ampersand Goto Github PK

A HTML5/javascript front end for tacocat.com's photo site.

Uses the following technologies:

• React.js: A component-based Javascript View layer that I'm madly in love with. So much easier than Backbone views. And so fast.
• Ampersand.js: Very similiar to Backbone.js but fully embraces tiny modules, npm, and browserify. I use it for its Models and Routing, not its Views.
• Browserify: The first javascript dependency management system that I can actually get working and KEEP working without having to think too hard. I hate Require.js and AMD. Browserify does its business using NPM and Node.js and I love it.
• Gulp.js: A javascript build system that replaces Grunt.js. Faster, easier to use.

Retrieves album data from tacocat's ZenPhoto installation. Depends on this prototype JSON REST backend (github).

1. Git - source control tool. Needed to retrieve this project from github.com
2. Node.js - Node.js server. Needed to manage development tools & run dev webserver. Not used at runtime
3. Compass - SASS CSS processor

• This will require installing Ruby. I highly recommend using RVM instead installing Ruby directly.

4. Bower - a javascript package manager.

• To install: npm install -g bower

1. Open terminal / shell
2. cd to directory under which you want to create project
3. Get this project via git clone [url to this project]
4. cd into project
5. Install the project's npm dependencies: npm install (must be in project root dir)
6. Install the project's bower dependencies: bower install (must be in project root dir)

1. cd into project
2. Run project: gulp watch. This will compile the code and start a development web server.
3. Open browser to localhost. In the output of gulp watch, it'll tell you what port the web server's on.
4. In the browser you should the root gallery of tacocat.com. If you don't, look in your browser's javascript console for what's going on.