VueTube/contributing.md

31 lines
2.3 KiB
Markdown
Raw Normal View History

2022-03-14 12:01:42 +00:00
# Contributing to VueTube
2022-03-14 19:59:38 +00:00
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](https://discord.gg/7P8KJrdd5W). Hopefully this page will help make the contributing experience as seamless as possible.
2022-03-14 12:01:42 +00:00
# Prerequisites
- Android Studio "Arctic Fox" or Later - [Download](https://developer.android.com/studio#downloads)
- NodeJS 16.x - [Download](https://nodejs.org/en/download/)
- Java JRE 1.8 - [Download your preferred java runner]
2022-03-15 20:14:44 +00:00
- Java JDK 1.8 - [Download your preferred JDK]
2022-03-14 12:01:42 +00:00
- (Optional) Xcode [iOS app development] - [Download](https://developer.apple.com/xcode/)
# Setup
2022-03-14 19:59:38 +00:00
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:
2022-03-14 12:01:42 +00:00
`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
2022-03-15 20:17:04 +00:00
2022-03-14 19:59:38 +00:00
> 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.
2022-03-14 12:01:42 +00:00
2022-03-17 23:34:43 +00:00
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!
2022-03-14 12:01:42 +00:00
# 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
2022-03-15 20:14:44 +00:00
We hope that you have had a smooth experience contributing the VueTube. Any additional questions or concerns can be asked on our [Discord server](https://discord.gg/7P8KJrdd5W).