etc
/
VueTube
mirror of https://github.com/VueTubeApp/VueTube
0
0
Fork 0
Code Issues Projects Releases Wiki Activity
VueTube/contributing.md

2.3 KiB
Raw Blame History

Contributing to VueTube

Hello! First of all, I'd like to say thank you for your interest in contributing to the VueTube project. If you haven't already, I'd like to extend to you a warm welcome to our Discord server. Hopefully this page will help make the contributing experience as seamless as possible.

Prerequisites

  • Android Studio "Arctic Fox" or Later - Download
  • NodeJS 16.x - Download
  • Java JRE 1.8 - [Download your preferred java runner]
  • Java JDK 1.8 - [Download your preferred JDK]
  • (Optional) Xcode [iOS app development] - Download

Setup

Now that you have everything installed, you can proceed with installing your node dependencies. You can do this with the following commands in the project's root directory: npm i; cd NUXT; npm i; cd ..

Testing

If you wish to test the app within your browser, you can enter the NUXT directory, and run npm run dev. You can then navigate to http://localhost:80/ in your favorite web browser.

NOTE: TESTING THE APPLICATION FROM WITHIN YOUR WEB BROWSER DISALLOWS SOME FEATURES FROM WORKING. PLEASE COMPILE TO YOUR ANDROID DEVICE BEFORE SUBMITTING YOUR PULL REQUEST

NOTE2: If you get an error about EACCES: permission denied 0.0.0.0:80, change the port in nuxt.config.js back to 3000.

If you're done with your changes and are ready to submit your code, there is one last step: compiling to your android device.

  • Plug in your Android or iOS device. (and make sure that ADB works for android by running adb devices in your ADB directory)
  • Then, in the root directory of the project, run ./scripts/build.ps1 on windows or ./scripts/build.sh for linux or mac.
  • Finally, run npx cap run android to push to your android device or npx cap run ios for your ios device!

Making a Pull Request

A pull request is fairly simple, and it's done here on GitHub. All we ask is that you include a few screenshots (and/or screen recordings) of what you've actually changed within the app.

Thanks

We hope that you have had a smooth experience contributing the VueTube. Any additional questions or concerns can be asked on our Discord server.