Core of the Amahi Platform, a web app in RoR
Ruby HTML CSS CoffeeScript JavaScript Makefile Python
Latest commit deb6c54 Oct 24, 2016 @bigfoot65 bigfoot65 committed on GitHub Merge pull request #124 from bigfoot65/master
Merge pull request #1 from amahi/master
Permalink
Failed to load latest commit information.
app Merge pull request #121 from xw19/master Oct 6, 2016
bin latest working platform for amahi 8 release Sep 2, 2015
config update rails to the latest. fix deprecation warnings Sep 3, 2015
db Adding tag 'tv' to teh existing tv share Jul 18, 2014
doc Full screen plugins layout and the documentation for how to use them Jul 8, 2014
lib Merge branch 'fedora-23' Jun 23, 2016
misc label the results coming out of search with an "active" class Mar 27, 2013
plugins report disk usage including data behind symlinks. closes #1808 Sep 12, 2015
public more properly formatted exception handler page Aug 4, 2013
script reset user password script for (amahi 7 and going forward) Jul 22, 2015
spec be_true is renamed to be_truthy Jun 23, 2014
test initial commit of the platform Nov 25, 2012
tmp add .gitkeep in tmp/ to make sure there is a tmp dir Feb 17, 2013
vendor initial commit of the platform Nov 25, 2012
.gitignore more cleanups to markup and base theme Mar 26, 2013
.powrc support for pow+rvm on mac os Mar 18, 2013
.ruby-version update bundle, s/yum/dnf/, add ruby 2.3 testing, set ruby version to … Jun 23, 2016
.travis.yml update bundle, s/yum/dnf/, add ruby 2.3 testing, set ruby version to … Jun 23, 2016
COPYING initial commit of the platform Nov 25, 2012
Gemfile update bundle, s/yum/dnf/, add ruby 2.3 testing, set ruby version to … Jun 23, 2016
Gemfile.lock update bundle, s/yum/dnf/, add ruby 2.3 testing, set ruby version to … Jun 23, 2016
Makefile update bundle, s/yum/dnf/, add ruby 2.3 testing, set ruby version to … Jun 23, 2016
README.md typo fixed Mar 2, 2015
Rakefile Change application name to be AmahiHDA rather than Html. Needed for p… Jan 10, 2013
TODO.txt Create TODO.txt Dec 11, 2012
config.ru latest working platform for amahi 8 release Sep 2, 2015
icla.txt add ICLA, for taking contributions Nov 30, 2012

README.md

Amahi Platform

Build Status Code Climate Dependency Status Coverage Status

The Amahi Platform is a web-based app that allows management of users, shares, apps, networking and other settings in a Linux-based PC, VM or ARM-based system.

The Amahi Platform is part of Amahi and supports the services provided by Amahi.

Contributing

Contributions are always welcome! Here's what you need to do to get the Amahi platform working:

1. Clone the repo

git clone https://github.com/amahi/platform.git

2. Run the tests

You can test Amahi locally with limited functionality either on the command line or in the browser and both should work. Tests are written in CoffeeScript using QUnit.

To run on the command line, run the following command from the project root:

make run-tests

3. Write some test-driven code

The tests are in spec/. All test files are typically inside spec/requests and we use capybara and factory-girl for easy test writing.

4. Test by hand in the browser

To run the app in the browser, you need to bootstrap it first. The first db: command assumes you have MySQL up and running and will ask for the root user credentials in MySQL:

bundle install
rake db:create
rake db:migrate
rake db:seed

To start the app and use it with a browser, start a web server with rails:

rails s

Visit http://localhost:3000/, login with the username of admin & the password of admin and excersise the app as much as you can.

We like to follow a particular git branching model. You can create and work in your own branch, making your work easier to track.

5. Coding Style

Try to remove suprious white spaces and such. We have a Ruby beautifier tool that we recommend. It's a basic ruby script that will modify any number of files (in the command line) to make them more readable and keep the formatting conventions and styles that we like in Amahi.

6. Create a pull request

When you are ready for your changes and it's good code that fits with the goals of the project, submit a pull request and we will merge it!

7. Agree to CLA

For mutual protection, please check the icla.txt file for the individual contributor agreement we require for contributors. It's a virtual copy to Apache's CLA. Generally, you will be asked by email to read it and accept, otherwise it will be implied that you accept it. If you are working for a company or some large institution, we will ask that you submit a scan of the signed CLA for us to keep on file.

8. Develop Plugins

We are trying to make the platform more modular and also thinner. If you have some ideas for plugins that would improve the platform but are better done as plugins, See the plugins docs file.

License

This program is Copyright (C) 2007-2013, Amahi. Licensed under the AGPL. See the license in the COPYING file.