Blah blah blah... placeholder for introductory text.
CTRL + CMD + Z will open the iOS simulator menu, and pressing Reload should refresh the app. R twice quickly will refresh the app.Clone the app and run npm install in both the frontend and backend directories.
npm i -D nodemon in the backend. It is in devDependencies in the package.json file, but people seem to have had issues with this in the past. It is recommended by Nodemon to install it globally with npm install -g nodemon..env file in the backend directory with the following variables:
MONGODB_PW=<our MongoDB Atlas password> (the actual password is shared privately with the group)npm run server will start the backend server on localhost:8080. This will connect to the database on MongoDB Atlas (once it is set up).
npm start will start the frontend in development mode. This will open a browser window with a QR code. You can scan this with your phone to open the app in the Expo Go app, or you can follow the terminal instructions to open the app in a simulator.
npm run ios will open the a QR code for iOS devices and open the app in an iOS simulator.
npm run android will open the a QR code for Android devices and open the app in an Android simulator.
npm start will start the frontend in development mode. This will open a browser window with a QR code. You can scan this with your phone to open the app in the Expo Go app, or you can follow the terminal instructions to open the app in a simulator.
npm run ios will open the a QR code for iOS devices and open the app in an iOS simulator.
npm run android will open the a QR code for Android devices and open the app in an Android simulator.
npm start will start the backend server on localhost:8080. This will connect to the database on MongoDB Atlas (once it is set up).
This React Native app was created using the Expo CLI. I have seen documentation suggesting you need to install it globally using npm install -g expo-cli, but have also seen suggestions this is deprecated so suggest you only run that if a need arises. As React Native is already set up, cloning the repo, cding into the frontend and running npm install should be all you need to do to set up expo-cli.
To view the app in iOS using a simulator or on an iphone you will need to install Xcode (and the Expo Go app for iPhone). Please see the Xcode page for more information.
To view the app in Android using a simulator or on an Android phone you will need to install Android Studio (and the Expo Go app for Android). Please see the Android Studio page for more information.
For debugging purposes, there is a health endpoint on the backend server.
http://localhost:8080/api/v1.0/health/server should return a JSON object with the message All is good with the server but I can't speak for the database. which confirms that the server is running.
http://localhost:8080/api/v1.0/health/db should return a JSON object with the status all is well which confirms that the server is running and that the database connection is good.
A POST request to http://localhost:8080/api/v1.0/health/db with a status property in the body will add that entry to the database and return {"message":"Health entry added successfully!"}.
NOTE: There is a Postman Aura Workspace with a collection of requests for the backend server.
The MongoDB database is hosted on MongoDB Atlas. The connection string is stored in the .env file in the backend directory. The connection string can be found in the backend app.js file.
There are three databases: aura, aura-DEV and aura-TEST. The development environment uses aura-DEV and please use aura-TEST for testing. The aura database is for production.
At time of writing, the databases contain only a health collection as referenced in the Backend server and health check section above.
The connection string for MongoDB Compass is mongodb+srv://pensano-aura-db-user:<password>@cluster0.sylisri.mongodb.net/, using the shared password.
The database collections can be seeded with using the seedCafes.js file in the backend directory.
cd backend to navigate to the backend directory.
npm run seed:cafes:dev will seed the cafes collection in the aura_DEV database.
npm run seed:cafes:test will seed the cafes collection in the aura_TEST database.
npm run seed:cafes:production:ARE_YOU_SURE_YOU_SHOULD_BE_DOING_THIS will seed the cafes collection in the aura production database.
IMPORTANT: All current production data will be lost if the above command is run.
cd backend to navigate to the backend directory.
IMPORTANT: When running any test that involves the database, please use the aura_TEST database by starting the server by running npm run start:test rather than the normal npm start, to preserve the aura_DEV database data.
To run ALL tests, run npm test in the backend directory. This will continuously run all backend tests until stopped with Ctrl+C.
To run specific tests, run npx jest <test file regex match> in the backend directory. For example, to run the userController.test.js file, you could run npx jest use. If that pattern matches multiple files, just be more specific, e.g. npx jest userCon.
To continuously run specific tests, run npx jest --watch <test file regex match>, e.g. npx jest --watch userCon.
NOTE: Any tests running App.js tests will have a delay before ending due to the open database pool connection. This is expected behaviour.
Resource links for the project, including the Athena Hackathon Team's documentation and useful links for React Native development can be found in the project documentation Resource and Learning md file.
All shared learning from the project can be found in the project documentation Resource and Learning md file.