🎵 Resonate Stream App

A mobile app for playing music on Resonate, an open source music streaming co-op.

The 🤖 Android App is available for open testing.

The 🍎 Apple/iOS App is available for external testing.

The Expo Project Page permits testing with the Expo Go client.

A demonstration video is available.

See the stream repository for more details.

🎶 Description

Resonate is an open-source music streaming service run by a cooperative of artists and software developers.

If you want to know what we're building or want to get more involved, head over to the Platform category on our forum or read the Developer Guide in our Resonate Handbook.

If you're looking for a good first task, feel encouraged to take on an un-assigned 'help wanted' issues.

Are you building something using the Resonate API and would like to request a change? Resonate welcomes #proposals in the Co-Operation section of the forum.

📦 Tech Stack

• Babel
• Expo
• React
• React Native
• TypeScript

🔧 Installation & Start

Clone this repository, install dependencies, and start expo.

git clone https://github.com/peterklingelhofer/stream-app.git
cd stream-app
yarn global add expo-cli
yarn
expo start

🧪 Testing

For testing, per #3 under Other issues to consider, we should probably also be testing (at-least locally) with the development branch of the stream repository considering the Wordpress transition should be launching within around early to mid March 2022 -- change the WebView source prop in App.tsx to source={{ uri: 'https://stream.resonate.ninja/discover' }}. As far as we know, the only difference for the streaming player should be signup/login flow and account settings.

📚 Contributing

Contributing to others’ projects is an avenue to learn new software development skills and experience new technologies. The pull request is how your personal contributions will be added to the project. The following is an overview of the Git project management workflow:

Search project for contribution instructions and follow them if present. Fork project repo from your personal Github account. Copy the fork and clone repo onto your local machine. Add the original repository (the you forked) as a remote called upstream. If you created your fork a while ago be sure to pull upstream changes into your local repository. Create a new branch to work on! Branch from develop if it exists, else from master. Implement/fix your feature. Follow the code style of the project, including indentation. If the project has included tests use them. Add additional tests or convert existing tests as necessary. Add or convert project documentation as needed. Push your working branch to your forked repo on Github. Make a pull request from your forked repo to the origin master or development branch if present. Once your pull request is merged, pull down upstream master to your local repo and delete any additional branch(es) you may have created. Commit messages should be written in present tense describing what the committed code does and not what you changed in the code.

📖 References

• Expo
• React Native
• TypeScript

📑 License

stream-app is licensed under the GNU General Public License v3.0

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

📇 Contact

[email protected]