Eskimo
Eskimo helps you to rapidly build Node powered API's, online stores, and apps in general (known as "igloos"). Requires Node >= 0.10.x, Redis for sessions, and your choice of either Knex/Bookshelf (SQL) or Mongoose (MongoDB) for data.
Index
- Sponsor
- Install
- Screencast
- Commands
- Examples
- Free Stickers
- Tests
- Conventions
- Contributors
- Credits
- License
Sponsor
Install
npm install -g eskimo
Documentation
The wiki is the main source for additional documentation.
Screencast
TODO: Basic screencast here
Commands
Bundled with the CLI are simple commands and options.
eskimo --helpUsage: eskimo [options] [command] Commands: create <dirname> create a new igloo model <name> create a new model view <name> create a new view controller <name> create a new controller mvc <name> create a new model, view, and controller Options: -h, --help output usage information -V, --version output the version number -N, --no-update-notifier disable update notifier -T, --no-tracking disable anonymous tracking
Once you've created an igloo, see the generated Readme.md file.
Usage samples:
# To create a new igloo in `./awesome`: eskimo create awesome # To create a new model, views, and controller (with routes and tests) for "tags", in `./app/views/tags/*.jade`, `./app/models/tag.js`, `./app/controllers/tags.js`, `./app/routes/tags.js`, and `./test/99-tags.test.js`: eskimo mvc tag# Note: You could write "tags" as well (no quotes necessary if there are no spaces) # To create a new controller (with routes and tests) in `./app/controllers/user-settings.js`, `./app/routes/user-settings.js`, and `./test/99-user-settings.test.js` eskimo controller 'user settings'# Note: You could write "user-settings" as well (no quotes necessary if there are no spaces)
Please read Igloo's documentation for more information. or your created igloo's
Readme.md
.
Examples
- Launching Soon Page
- Stripe-powered Store
- RESTful API
- Zero-downtime Reloads
- Referral System
- Facebook & Google Log In
- Webhook Deploys
- CDN-hosted Assets
Free Stickers
Want a free Eskimo snow shoes sticker? Just submit this form.
Tests
To run tests you'll need to have configuration set up. Config lives under /boot/config.js
(as stated before).
We've provided a base config template, which you will need to copy it to your local folder in order to run tests.
cp ./templates/boot/config.js ./boot/config.js
npm install -dnpm test
Assets
Assets refer to static files (scripts, stylesheets and other assets) placed in assets/public. To build a production version of your app:
gulp build
Note: This will minify all assets and create a ./assets/dist
folder optimized and ready for deployment.
List of tasks executed during gulp build
:
- Automatic LESS processing
- Automatic install of Bower packages
- Automatic images minification
- Automatic
usemin
implementation (concat, rev, ...)
Below is an example of a Jade file using usemin
blocks:
//- # layout //- ... //- build:js /js/app.jsblock scripts script(src='/bower/jquery/dist/jquery.js') script(src='/bower/bootstrap/dist/js/bootstrap.js') script(src='/bower/bootbox/bootbox.js') script(src='/js/plugins.js') script(src='/js/main.js') if settings.facebook.enabled script(src='/js/fb-appended-hash-bug-fix.js')//- endbuild
After running gulp build
, the file will be optimized:
//- # layout //- ... script(src='/js/app-316568f4.js')
Conventions
See nifty-conventions for code guidelines, general project requirements, and git workflow.
Contributors
Credits
- Snow Shoes by Marc Serre from The Noun Project
- ESKIMO IGLOO (color palette)