![Screenshot of the application](https://user-images.githubusercontent.com/1292230/112733102-9c6ffe00-8f46-11eb-9e6a-5ce9730abae9.png)
First install the Expo App for Android or iOS and open it.
Then scan the following QR code though the app:
![QR code for the app](https://user-images.githubusercontent.com/1292230/112733252-74cd6580-8f47-11eb-8a07-56944cc44e24.png)
Alternatively, you can open this link
App developed within the University of Helsinki's Full Stack Web Development course.
You can check the API visiting: https://rate-repository-api-fcole90.herokuapp.com/graphql
Backend from https://github.com/fullstack-hy2020/rate-repository-api
Node (versions 12.X.X
are tested, but later versions might work as well) and npm. If you haven't installed Node or npm, nvm is an easy to use tool for installing both. Nvm is also handy if you want to quickly switch between different Node versions.
-
Clone this repository and run
npm install
in therate-repository-api
directory. -
Rate Repository API uses the GitHub API, which has a quite small rate limit (60 requests per hour) for unauthorized requests. Therefore, we need to register it as an OAuth application to obtain client credentials. Register your OAuth application here by setting "Application name" as "Rate Repository API", "Homepage URL" as https://github.com/fullstack-hy2020/rate-repository-api and "Authorization callback URL" as http://localhost:5000. Now you should see your application here and by going to the application's page, see the "Client ID" and "Client Secret" values.
-
Create a file
.env
in therate-repository-api
directory and copy the contents of the.env.template
file there. In the.env
file, replaceGITHUB_CLIENT_ID
, andGITHUB_CLIENT_SECRET
variable values with your newly registered OAuth application's credentials. -
Run
npm run build
. This will setup the SQLite database and run the migrations. -
(Optional) To populate the database with some seed data you can run
npm run seed:run
. Note: running this command will remove all existing data. -
All done! Just run
npm start
to start the server. After the server has started you should be able to access the GraphQL playground at http://localhost:5000/graphql.
To list all the registered users, you can run this query in the GraphQL playground:
{
users {
edges {
node {
username
}
}
}
}
You can retrieve an access token by performing the authorize
mutation:
mutation {
authorize(credentials: { username: "kalle", password: "password" }) {
accessToken
}
}
All access tokens expire after seven days. If you performed step 5. in the "Getting started" section, users "kalle", "elina" and "matti" all have the password "password".
You can also register a new user by performing the createUser
mutation:
mutation {
createUser(user: { username: "myusername", password: "mypassword" }) {
id
username
}
}
A handy way to authorize requests in the GraphQL playground is to retrieve an access token using the authorize
mutation (see above for details) and then add the following in the "HTTP HEADERS" tab below the query editor:
{
"Authorization": "Bearer <ACCESS_TOKEN>"
}
Replace the <ACCESS_TOKEN>
part with your access token.
GraphQL playground offers documentation on how to use the API. Start the server by running npm start
, open the GraphQL playground at http://localhost:5000/graphql and click the "docs" tab.
Submit an issue with the bug description and a way to reproduce the bug. If you have already come up with a solution, we will gladly accept a pull request.
-
How to reset the database? If you are absolutely sure that you want to remove all the existing data, just remove the
database.sqlite
file in therate-repository-api
directory and runnpm run build
. You can runnpm run seed:run
to initialize the new database with seed data. -
Is this production ready? Almost. The current version of the API utilizes the SQLite database, which is not quite suitable for production. Luckily, all database queries are performed with Objection ORM, and changing the underlying database driver is just a matter of configuration.