DevinCLane/100freelancers

100freelancers

100freelancers is a tool to keep track of potential web development freelance clients.

View Demo · Report Bug · Request Feature

📃 About

100freelancers was originally created to help members of the 100devs agency keep track of their client outreach. Rather than using spreadsheets, which can be messy and difficult to read, 100freelancers can be used instead to easily add, view, and track clients, as well as progress made on client work.

💻 Tech Stack

🔧 Structure

The wireframe below outlines the project's models and general layout. Authentication is done through Passport's Discord strategy.

Progress

Currently, the project has functional authentication and session storage through Passport, as well as functional adding of clients and outreach. There is also support for light/dark mode using DaisyUI. See below for screenshots!

📝 Installation

This app uses NPM to manage its dependences and packages.

Fork and clone the repo

git clone https://github.com/devlarabar/100freelancers.git

Run the following in both the client and server directories:
```
npm install
```
Create an .env file in server/config/ and in client/. Copy everything from the respective .env.example files in both directories into these new files. Do not delete the example!
We have a local MongoDB instance set up through Docker. Docker Desktop will need to be installed to run the database. You can manage it using the following commands:
```
To start the local MongoDB instance, run:

npm run db:up

To stop the local MongoDB instance, run:

npm run db:stop
```
With the local MongoDB instance in place, you can now connect directly without the need for MongoDB Atlas during development.

To connect to the local MongoDB instance, follow these steps:
1. Open MongoDB Compass.
2. In the MongoDB Compass connection dialog, locate the "Connection String" field.
3. In your .env file, located in the server directory, copy the DB_STRING into the "Connection String" field
4. Click "Connect" to establish a connection to your local MongoDB instance.
To run the app locally, navigate to the client directory and run:
```
npm run dev
```
Then navigate to the server directory and run:
```
npm run db:up
npm run serve
```

Contributing

Anyone is welcome to contribute! The following simplified example of the git workflow is what we will be following for the development of this app.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

When creating your Pull Request, please make sure to be as descriptive as possible about your changes. Explain what your pull request solves if it's not resolving an existing issue.