Giter Club home page Giter Club logo

craftsmen's Introduction

Craftsmen

Simple Craftsmen Listing based on top of microscratch

Preview

preview]

Project Status

GitHub version Build Status Dependency Status Code Climate Total views Bitdeli Badge

Uptime

uptime

What microscratch is - first day in school

What is the microscratch?

microscratch is minimalistic opionated modern web application framework.

For clarification of words and term used please see glossary.

What are the principles?

  • Being idiomatic - All code in any code-base should look like a single person typed it, no matter how many people contributed.
  • Asking smart questions.

Why is called microscratch?

It is smaller brother of "the scratch". Google for it.

Is it really so micro?

It depends. Compared with what? Reports will be added soon...

Why should I choose microscratch?

  • It's open-source and will be!
  • It's quite small
  • It's quite modular
  • It's quite easy to understand
  • It's tested
  • It's continuously integrated
  • It's under the code QA
  • It's up-to-date

Will the microscratch fit me?

It depends. What are your needs? There is no silver bullet.

Is it production ready?

It depends. If is the node.js, mongo and/or ember are production ready for you then microscratch is ready too...

Installation

Is the installation difficult?

No. It will take you only few seconds, lets try...

What are the prerequisites?

If you have following, you should be ready to go.

  • git

    Git is a free and open source distributed version control system.

  • node.js

    Node.js is a platform built on Chrome's JavaScript runtime

  • mongodb

    MongoDB (from "humongous") is an open-source document database.

What is the easiest way to try?

If you have stuff mentioned above installed try this.

# Install grunt and bower
sudo npm install -g bower mocha mocha-phantomjs phantomjs grunt grunt-cli forever [email protected]

# Install sass ruby gem
sudo gem install sass

# Clone repository
git clone http://github.com/korczis/microscratch.git

# Install required node modules
npm install

# Or
sudo npm install

# Install required bower modules
bower install

# Compile assets
grunt build

# Run application
node app.js

Troubleshooting

Mac OS X

If you run grunt server you may get an error:

Running "watch" task
Waiting...Warning: EMFILE, too many open files

This is because default ulimit on Mac OS X is 256. Increate number of possibly open files to 10000 by:

ulimit -n 10000

First start

  • What is happening during the boot sequence?
  • What are the main configs?
  • Can I add my own initializers?
  • What are the steps in bootstrap process?
  • How can I override option from CLI?

CLI

  • What is CLI?
  • How to use CLI?
  • Are there any CLI examples?

Communication

  • How can I communicate?
  • How can I communicate horizontally?
  • How can I communicate vertically?
  • How can I communicate between modules?
  • How can I communicate between apps?
  • How can I communicate between clients?
  • How can I communicate between servers?

Technologies - Under the hood

  • What technologies do you use?
  • What is the usage of technology 'XYZ' ?
  • Why was the technology 'XYZ' chosen instead of 'ABC' ?
  • Can I replace technology 'XYZ' with ... ?
  • Is the technology 'XYZ' needed? I can no use it? Do you have fallback?

DIY - Do It Yourself

  • How can I add my own environment?
  • How can I add my own module?
  • How can I add my own application?

Deploy and monitor - Going wild

  • How can I deploy microscratch application?
  • How can I monitor my microscratch application?

Hacking - Under the hood

  • How can I hook to module events?
  • How can I hook to application events?
  • How can I hook to client events?
  • How can I hook to server events?

Film about film making

  • What was the inspiration for modules layer?
  • What was the inspiration for applications layer?
  • What was the inspiration for clients layer?
  • What was the inspiration for servers layer?

Collaborating

  • How can I report issue?
  • How can I propose feature?
  • How can I help as developer?

References

To Be Done

craftsmen's People

Contributors

korczis avatar pavelbinar avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.