Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
css
 
 
 
 
js
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Oxford

Oxford is a front-end skeleton framework for rapid website development, created by John Kreitlow and maintained by the Dev Team at Deep Focus.

The main purpose of Oxford is to provide a set of useful tools and libraries in a consistent structure that promotes healthy code style and unbiased flexibility while making as few assumptions as possible.

First Steps

To use Oxford, clone the repository or pull it into your existing project. We usually do this with a git subtree, which squashes the commit history and places it neatly into your project:

$ git subtree add --prefix ./assets https://github.com/DeepFocus/oxford.git master --squash

More information on git subtree can be found here.

Then, simply navigate to the newly-grabbed folder and run npm install. This will ensure all the expected grunt tasks are available.

Then grunt dev to get to work!

Up and Running

A Few Assumptions

The initial release of Oxford uses these languages and libraries, since we use them frequently in our projects. Future variants of Oxford may have different requirements and dependencies.

Tools

Javascript libraries

Less

A Few Gotchas

There are some key quirks in this project that may be overlooked, so here they are upfront, in list form.

  • Our JavaScript modules use tabs instead of spaces. You can change this in your own project if you see fit. Our projects enforce tabs and other style requirements with jscs. This only applies to scripts in js/main.js and the js/app directory.
  • The bower.json file is mainly intended for use with the grunt-bowercopy task.
  • There is one entry point for Less compilation, which is less/style.less. This is not to be confused with less/styles/_styles.less.
  • The Less output is currently not minified or compressed. You may want to use grunt-contrib-cssmin in the meantime.

License

By contributing your code, you agree to license your contribution under the MIT License.

About

A front-end skeleton framework for rapid website development. Maintained in tandem with https://github.com/DeepFocus/oxford

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published