Skip to content

orhankhanbayov/Solved-Arrogate

Repository files navigation

Solved - The Mystery Walks App

This mobile app was created as final project by team of 5 junior software engineers at Makers Academy:

Orhan Khanbayov, David Scott, Juliana Nocchi, Marta Bianchini, Michal Smyk

We didn't just stumble upon the idea for this app by accident. It all started with maps...but ended up being so much more!

Check out our:

🚀 Demo

🚀 Presentation

🚀 Screens examples:

About the App

Solved is a live-action treasure hunting game that leads you on an exciting tour of a city neighbourhood. In each Solved treasure hunt you will use your knowledge of the city to search for five secret landmarks. During your adventure you’ll win coins, get recommendations for local cafes and restaurants and learn some amazing facts!

Getting started

To run the app you will need:

  • Node.js
  • XCode Developer Tools (iOS simulator)
  • Android Studio (android emulator)

Node.js

💻 You will need Node.js on your machine. If you don't have it you can install it using this command line in your terminal with brew for macOS.

$ brew install node

Or on Windows machine, go to Node.js website and follow the instructions.

The following guidance shows how to use NPM to setup and manage a JavaScript project and its dependencies.

If you don't have NVM ( Node Version Manager) on your machine click here to install it.

XCode Developer Tools

💻 Install XCode Developer Tools

Android Studio

💻 Install Android Studio

After Android Studio installation is completed, you will need to adjust the SDK settings:

Settings --> System Settings --> Android SDK --> go to the tab "DSK Platforms" and one at the time, click to download:

  • Android SDK Build-Tools 34-rc1
  • Android TiramisuPrivacySandbox Preview

Then, go to the tab "DSK Tools" and one at the time, click to download:

  • Android SDK Build-Tools 34-rc1
  • Android SDK Command-line Tools

Then, follow the instructions (steps 5 to 8), from Android Studio Emulator

Google API

First step to getting an API (or starting any project using google ‘stuff’) is setting up an account here.

You need to enter a bank card even with a free-use plan.

Once signed up it creates a generic/default starter project and generates an API key. But you can select ‘new project’ and it will give you another key specific to that one. When you API key is active you will also need to enable Google Vision, Places and Directions

TripAdvisor

To get TripAdvisor API key go to developer page and create you API key.

API keys usage

Once your both API keys are active, you will need to create an .env file in frontend direcotry. Save your Google and TripAdvisor keys there

API_KEY=//your TripAdvisor key here//
GOOGLE_API=//your Google key here//

Usage

Navigate to api directory:

$ cd api

$ npm install

Then

$ cd ../frontend

$ npm install

Then to run the server, in frontend directory :

$ npx expo start

Once expo server is running and you have Xcode and Android simulator installed press i for iOS simulator and a for Android simulator.

You can also see a rendering of the app using an iOS/Android phone and the Expo Go app. After downloading the Expo Go app you will be able to scan a QR code displayed when you run npx expo start in your terminal.

Running tests

To run the tests, run this command line in main directory:

$ jest

Technologies

MERN stack with React Native

Technology
MongoDB Atlas mongoDB
Express Express
React Native React
Node.js Node.js
JavaSript JavaScript
CSS CSS