etc/VueTube
0
0
Fork 0
mirror of https://github.com/VueTubeApp/VueTube synced 2024-11-22 11:15:14 +00:00
Code Issues Projects Releases Wiki Activity
VueTube/contributing.md
Jackson Chen 6ccb9edba8
add extra line to separate second note
2022-03-15 21:17:04 +01:00

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. Then, in the root directory of the project, run npx cap run android to test on your Android device or npx cap run ios to test on your iPhone. The app will proceed to build and you will be asked what device to install the debug application on. Select your device and wait as it compiles for you! Hopefully everything goes smoothly, and you are ready to make your pull request!

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.