Snapper Project Setup

Prerequisites

Before you begin, ensure you have the following installed on your system:

• Node.js (v16 or higher)
• Docker
• Task
• MongoDB
• Expo CLI (for running the frontend on mobile devices)

Ensure you have environment variables set up for development by creating a .env file.

Project Structure

The project is divided into two main parts:

1. Frontend (located in the frontend directory):

   • Built using React Native + Expo.
   • Cross-platform support for iOS, Android, and web.

2. Backend (located in the backend directory):

   • Built using Node.js + Express.
   • MongoDB for database operations.
   • Supabase for authentication.

Getting Started

1. Clone the repository

git clone https://github.com/your-repo/snapper.git
cd snapper

2. Install Dependencies

We use Taskfile to streamline setting up the project.

task install

This command will install dependencies for both frontend and backend.

3. Set up your .env

Create a .env in the root directory containing the following:

NODE_ENV=development
SERVER_PORT=3000

4. Running the Application

You can start the frontend and backend simultaneously by running:

docker compose up
task start

Or, you can start each service separately:

• Frontend (React Native):

task frontend:start

• Backend (Express):

task backend:start

5. Running in Development Mode

For development, where you may want auto-reload features:

task backend:dev

7. Testing

To run the backend tests, use:

task backend:test

We use Jest for testing the backend.

Backend Routes Overview

Here’s an overview of the important backend routes:

Auth Routes: POST /auth/register: Register a new user.

POST /auth/login: Log in an existing user.

POST /auth/logout: Log out the user.

Healthcheck:

GET /ping: Check server status, requires authentication.

Contribution Guidelines

Please make sure to create a new branch for every feature you work on, and always create a pull request for code review. Ensure that all tests pass locally before submitting your PR.

Test Flight

EXPO_NO_KEYCHAIN=1 eas build -p ios --profile production --auto-submit

Questions or Issues?

If you run into any problems, feel free to slack me!

Happy coding! 🐠