search

lloydtorres / stately

A NationStates app for Android.
https://play.google.com/store/apps/details?id=com.lloydtorres.stately
Apache License 2.0
32 stars 8 forks source link
android nationstates

readme

Stately

Stately is an unofficial NationStates app for Android.

Get Stately on: Google Play | Amazon Appstore | F-Droid

Features

Revision History

Detailed release notes and APKs can be found in the releases page.

Contributions

Stately is an open-source project — contributions are always welcome! Please keep in mind the following project tenets before working with Stately code:

  1. Improve the NationStates experience, don't detract from it. NationStates players should be able to jump right into Stately and figure out how things work intuitively. Features shouldn't stray too far from convention and confuse players.
  2. The Material Design aesthetic comes first. Stately prides itself on its clean, sleek and modern interface based on Material Design. Features should match or improve upon the app's existing aesthetic.
  3. Security and privacy are paramount. Stately should only interact with NationStates when handling user data. Other than receiving crash reports, Stately's developers should not be aware of any actions in the app.
  4. Compatibility should be maintained whenever possible. Stately runs on a variety of Android devices. Future updates should work on both modern flagship phones and on older devices we've previously supported.
  5. Off-the-shelf solutions work better in the long run. To keep Stately robust, changes should be built on stock Android libraries and existing dependencies. Data consumed from the NationStates API should be from documented shards.

All proposed changes to the app should be submitted as pull requests to the main GitHub repository. Additionally, major changes (e.g. new features or UI changes) should have a tracking issue for it. The project owner will work with the contributor on getting their code released in an app update through these channels.

Translations

Stately is entirely dependent on NationStates and its API, which provides in-game content (such as issues and nation descriptions) solely in English; a significant portion of Stately will therefore still be in English even if every in-app string is translated into another language. As a result, in-app string translations will not be accepted at this time.

Attributions

Stately uses the following open-source libraries:

Stately uses Creative Commons-licensed content from the following sources:

License

Copyright 2016-2024 Lloyd Torres

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.