Decentralized marketplace for Open Source software developement
To report a bug or request a feature or change please open a new issue
Other useful links
If you don't have Git installed, you will need to this in order to build: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
Make sure the git binary is on $PATH.
If you do not have Node installed, please install the latest LTS release: https://nodejs.org/en/
You need Java 8 to run the platform. Please download and install from here: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
Make sure you set the
JAVA_HOME environment variable: http://www.baeldung.com/java-home-on-windows-7-8-10-mac-os-x-linux
Fork and Clone the repository
Fork the repository, to afterwards clone it to a local directory
To run the dependencies, you need to have Docker installed: You can run these dependencies using Docker: https://www.docker.com/community-edition
FundRequest has several dependencies to run locally:
- Database (MariaDB)
- Message broker (RabbitMQ)
- Azrael (Solution from FundRequest to abstract blockchain related transactions)
Azrael needs an ethereum account to execute its transactions (e.g. claim, refund). This account needs to have Kovan ETH on it to cover the transaction fees. To acquire this, just post your address in this Gitter channel: https://gitter.im/kovan-testnet/faucet
To link your account to Azrael, create the following file
core/.env with contents:
To be able to use the refund functionality, your execute account needs to be whitelisted in our contract. You can send it to us via Telegram (https://t.me/FundRequestDevs) and we will whitelist it for you.
Running the dependencies
To start the dependencies, go inside the cloned repository and execute
Configure application properties
tweb/src/main/resources/application-credentials.properties and edit properties
admin-web/src/main/resources/application-credentials.properties and edit properties
feign.client.github.username=<your github username> #create a developer access token on github: https://github.com/settings/tokens feign.client.github.password=<your github token> local.ethereum.kovan.address=<your ethereum address>
- To acquire Kovan ETH, just post your ETH address in this Gitter channel : https://gitter.im/kovan-testnet/faucet
- To acquire Kovan FND, for now just ask us in our telegram channel : https://t.me/fundrequestofficial
You have 2 options to start the application. If you didn't work with maven/spring boot in the past, you can use the quick setup. If you have experience, please go to the import guide below.
To run the application, execute:
build.shon Linux/Mac and
build.baton Windows. This script will build the entire project, if you make any changes, rerun this script. Building the first time will take a bit longer.
runPlatform.shon Linux/Mac and
runPlatform.bat. This will run the platform, when rebuilding stop this script first.
runAdmin.shon Linux/Mac and
runAdmin.bat. This will run the admin panel, when rebuilding stop this script first.
Import - better for development
The application is a standard maven / spring boot setup. For local development you have to start the application
with the spring profile
You can import the entire project using your favourite IDE.
To start the platform, you can run the java class:
To start the admin panel, you can run the java class:
For changes in the frontend parts (scss, ts, vue, ...) there are some node scripts to rebuild/recompile changes on the fly during development.
- Go to
npm install(installs all node dependencies)
npm run watchto rebuild all styles on change. (Changes will be directly visible on a browser refresh.)
npm run webpack-watchto rebuild all .ts and .vue on change. (Changes will be directly visible on a browser refresh.)
The platform is available on
User: johndoe Password: test
The admin panel is available on
User: admin Password: test