Skip to content
This repository has been archived by the owner on Sep 12, 2023. It is now read-only.

Tacocat photo gallery front end using React, Ampersand, Browserify, Gulp

License

Notifications You must be signed in to change notification settings

deanmoses/tacocat-gallery-react-ampersand

Repository files navigation

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

Technologies

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).

How To Work With Project

Install prerequisites

  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.
  1. Bower - a javascript package manager.
  • To install: npm install -g bower

Install project

  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)

Run project

  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.