Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dbankier/JAST

JAST is a boilerplate with a mash of tools for rapid Alloy development
https://github.com/dbankier/JAST

Last synced: about 1 month ago
JSON representation

JAST is a boilerplate with a mash of tools for rapid Alloy development

Awesome Lists containing this project

README 

        
# JAST Stack



**PLEASE NOTE:** the project structure has changed. Read below and only upgrade old projects with great caution.



JAST is a boilerplate with a  mash of tools for rapid Alloy development. Let's be opinionated then. The stack includes:



 * [Alloy](http://projects.appcelerator.com/alloy/docs/Alloy-bootstrap/index.html) -

   Appcelerator's own MVC Framework

 * [Babel](https://babeljs.io/) - to give us some ES6 support.

 * [Jade](http://jade-lang.com/) - the [best](http://www.yydigital.com/blog/2013/7/10/A_Case_For_Jade_With_Alloy) template

   engine for alloy views

 * [STSS](https://github.com/RonaldTreur/STSS) - Sassy TSS, or Sassy Titanium Style Sheets.

 * [TiShadow](http://tishadow.yydigital.com/) - the fastest __Open Source__ toolset

   for titanium development.



And these libraries:

 * [XHR](https://github.com/raulriera/XHR) - a new XHR wrapper.



And these widgets:

 * [nl.fokkezb.loading](https://github.com/FokkeZB/nl.fokkezb.loading) - simple loading widget

 * yy.alert - yet another alert widget.



~~See the following (outdated) [demo](http://www.youtube.com/watch?v=c1u92zT-oA4) - it uses LTSS instead of STSS but you'll get the idea.~~



If you would like coffee with that see [grunt-titanium-tishadow](https://github.com/xissy/grunt-titanium-tishadow).



# Prerequisites



 * [Get started](http://tishadow.yydigital.com/getting%20started) with TiShadow



# Let's Go



## Configuration



The configuration is at the head of the `Gruntfile.js`.



You **must** modify the `ti_args` values to suit your environment.

The `ti info` command can help to get the correct ios simulator device id.



You can optionally modify `Project Specific Definitions` section.



## Manually



 * `git clone https://github.com/dbankier/JAST.git`

 * `[sudo] npm install alloy tishadow`

 * `cd JAST && [sudo] npm install`

 * `grunt dev --p=iphone`



**Note**: the `grunt dev` command will start the tishadow server and launch a tishadow appified version of your app.

All code changes will be selectively precompiled and pushed (live-reload).



## Manual Install with Extras :+1:



If you want to:

 * use selective alloy compilation for super fast live reloads.



You will need to install alloy from master and at least v.2.8.0 of tishadow - follow these steps.



 * `git clone https://github.com/dbankier/JAST.git`

 * `[sudo] npm install -g git://github.com/appcelerator/alloy.git`

 * `[sudo] npm install -g tishadow`

 * `tishadow config --boost`

 * `cd JAST && [sudo] npm install`

 * `grunt dev --p=iphone`



## Use the [Yeoman](http://yeoman.io) generator: [generator-alloy](https://github.com/dbankier/generator-alloy)



** NEEDS UPDATING - OUTDATED**

```

 npm install -g yo generator-alloy

 mkdir /path/to/new/app && cd $_

 yo alloy

```



If you want to use



# Structure



Make **ALL** changes in the `src` directory.

The **ENTIRE** `app` directory will be cleaned on `grunt clean`.



# Commands



 * `grunt` - compiles the jade, stss and es6 files and copies all the assets from `src` to `app`

 * `grunt dev [--p=]` - auto compile and pushes with TiShadow (`p` flag is optional)

 * `grunt test [--p=]` - run specs  (`p` flag is optional)

 * `grunt clean` - deletes all generated files

 * `grunt [iphone6|iphone7|ipad6|ipad7|appstore|adhoc|playstore]` - commands inspired by the work

    of @FokkeZB on [TiNy](https://github.com/FokkeZB/tn). Project specific settings are configured at

    the top of the `Gruntfile.js`.



License: MIT