https://github.com/espy/admin-dashboard

Ember rewrite of the Hoodie Admin Dashboard
https://github.com/espy/admin-dashboard

Last synced: 10 days ago
JSON representation

Ember rewrite of the Hoodie Admin Dashboard

• Host: GitHub
• URL: https://github.com/espy/admin-dashboard
• Owner: espy
• Created: 2015-07-15T14:52:40.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-10-17T10:59:27.000Z (about 7 years ago)
• Last Synced: 2024-11-08T03:12:25.793Z (2 months ago)
• Language: JavaScript
• Size: 2.51 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Admin-dashboard

Ember version of the Hoodie Admin Dashboard. Currently lets you log in and out, fetch all the plugin info, display plugin backends, and is ready to handle requests to Hoodie that require authentication. All Ajax requests done through Ember will transmit the bearerToken correctly once the admin has signed in.

## Prerequisites

You will need the following things properly installed on your computer.

* [Git](http://git-scm.com/)

* [Node.js](http://nodejs.org/) (with NPM)

* [Bower](http://bower.io/)

* [Ember CLI](http://www.ember-cli.com/)

* [PhantomJS](http://phantomjs.org/)

## Installation

* `git clone ` this repository

* change into the new directory

* `npm install`

* `bower install`

## Running / Development

This admin dashboard is meant to run in conjunction with an actual Hoodie app, so you'll need to run a Hoodie app locally and then tell Ember where the `WWW`-endpoint of that Hoodie app is. For example:

* `ember server --proxy http://127.0.0.1:6096`

* Visit your app at [http://localhost:4200](http://localhost:4200).

This'll handle all requests to the Hoodie API without any CORS trouble or additional config. 

#### Oddities of Note

This app embeds third-party plugin dashboards **iframes**, the sources of which are provided by the proxied Hoodie API. This only works if the Ember environment variable `locationType` is set to `hash` in `config/environment.js`. Otherwise, Ember will expect a route handler for the iframe src, and that will mess everything up. This means that the app's URLs use hashes.

#### Working on admin-dashboard-UIKit (needs revision)

Clone `[email protected]:hoodiehq/hoodie-admin-dashboard-UIKit.git` and do `$ npm link` in its directory. This will make a global npm package named `hoodie-admin-dashboard-UIKit` available on your system.

Now go to `yourHoodieTestApp/node_modules/hoodie-server/node_modules` and do `$ npm link hoodie-admin-dashboard-UIKit`.

You can now work in your UIKit-folder and see the changes in your admin-dashboard's plugins. Don't forget to `$ grunt build` the UIKit first.

#### Working on a plugin (needs revision)

Clone the plugin and do `$ npm link` in its directory. This will make a global npm package named `hoodie-plugin-pluginName` available on your system.

If the plugin exists in npm already, you can install it now via `$ hoodie install pluginName`.

Now go to `yourHoodieTestApp/node_modules` and do `$ npm link hoodie-plugin-pluginName`.

If the plugin is new and not installable through `$hoodie install`, you will have to add it to the package.json manually.

### Code Generators

Make use of the many generators for code, try `ember help generate` for more details

### Running Tests

* `ember test`

* `ember test --server`

### Building

* `ember build` (development)

* `ember build --environment production` (production)

**Important:** Don't forget to set the environment when building for release, the difference in asset size is immense (the build with `--environment production` is 950Kb, without it's **12MB**).

The app is built into the `www` folder to match the path in the existing dashboard. Ths path is set in `.ember-cli`.

### Release Process

TBD.

## Further Reading / Useful Links

* [ember.js](http://emberjs.com/)

* [ember-cli](http://www.ember-cli.com/)

* Development Browser Extensions

  * [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)

  * [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)