https://github.com/sayandedotcom/refhired.com
( Under Modification [ integrating AI ], made public on May 2025 for recruiters ) Simplifying receiving and giving job referrals for absolutely everyone ! 💼
https://github.com/sayandedotcom/refhired.com
apollo-server-client aws aws-aurora aws-lambda aws-s3 github-actions graphql langchain-js next-auth nextjs14 nodejs postgresql prisma redis resend-email sst stripe tailwindcss turborepo typescript
Last synced: 3 months ago
JSON representation
( Under Modification [ integrating AI ], made public on May 2025 for recruiters ) Simplifying receiving and giving job referrals for absolutely everyone ! 💼
- Host: GitHub
- URL: https://github.com/sayandedotcom/refhired.com
- Owner: sayandedotcom
- License: mit
- Created: 2023-05-12T21:13:46.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-14T15:49:56.000Z (12 months ago)
- Last Synced: 2025-07-14T20:05:21.879Z (11 months ago)
- Topics: apollo-server-client, aws, aws-aurora, aws-lambda, aws-s3, github-actions, graphql, langchain-js, next-auth, nextjs14, nodejs, postgresql, prisma, redis, resend-email, sst, stripe, tailwindcss, turborepo, typescript
- Language: TypeScript
- Homepage: https://refhired.sayande.com/
- Size: 5.78 MB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Refhired.com
Hire and apply only through referrals !
Learn more »
This is a solo project by [Sayan De](https://github.com/sayandedotcom). Read more about the project in this [blog](https://blogs.sayande.com/refhiredcom-what-is-it-a-side-hustle-that-boosted-my-career-skills-confidence-knowledge-etc)
## Architecture
## Contributing
Guidelines for contributing can be found in [CONTRIBUTING.md](https://github.com/sayandedotcom/refhired.com/blob/main/CONTRIBUTING.md).
## Main domains
| Domain | Tech | Version |
| ------------------------- | ------------------- | ------- |
| Repository Tool | Turborepo | 1.9 |
| Primary Language | TypeScript | 4.5 |
| Front-End | Next.js | 14+ |
| Back-End | Node.js | 20.9.0 |
| API | GraphQL with Apollo | - |
| Authentication | Next-Auth | 4 |
| Styling | Tailwind CSS | 3.3 |
| Database ORM | Prisma | 4.15 |
| Primary Database | PostgreSQL | 15.3 |
| Caching Database | Redis | - |
| Unit Testing | Vitest | 0.33.0 |
| End to end Testing | Playwright | 1.36.2 |
| Containerization | Docker | - |
| CI/CD | GitHub Actions | - |
| Deployment Franework | SST | 2+ |
| Deployment | AWS | - |
| Front-End Deployment | AWS Lambda & S3 | - |
| Back-End Deployment | AWS Lambda | - |
| Database Deployment | AWS Aurora Postgres | - |
| Cache Database Deployment | AWS ElastiCache | - |
| Static Assests | AWS S3 | - |
| CDN | AWS CloudFront | - |
| Routing | AWS Route 53 | - |
| Version Control | GitHub | - |
| Code Editor | VS Code | - |
### Workspaces List
| Index No. | Workspace/Folder | Info. | Name | Navigate | Port |
| --------- | ---------------- | ---------------- | -------------------- | ------------ | ---- |
| apps / | | | | | |
| 1 | api | For API Server | @refhiredcom/api | yarn api | 8000 |
| 2 | blogs | For blogs | @refhiredcom/blogs | yarn blogs | - |
| 3 | desktop | For desktop app | @refhiredcom/desktop | yarn desktop | - |
| 4 | docs | For docs | @refhiredcom/docs | yarn docs | - |
| 5 | mobile | For mobile app | @refhiredcom/mobile | yarn mobile | - |
| 6 | storybook | For Storybook | @referrer/storybook | yarn story | 6006 |
| 7 | swagger | For desktop app | @refhiredcom/desktop | yarn desktop | - |
| 8 | web | For main website | @refhiredcom/web | yarn web | 3000 |
## Things I am stuck with
Using the latest Next.js 14 -Using the latest Next.js 14 comes with a cost. Every library has some special and different configurations for the latest Next.js versions, especially versions above 13. I am currently stuck with a bug in next-intl which is breaking the parallel and intercepting route in productions, and another problem is with the Apollo Client. The bug is you have to encrypt and then pass cookies to the Apollo wrapper component and then decrypt and pass the cookies to the Apollo server.
Deploying with SST - I decided to transition the deployment platform from Vercel to AWS to gain more control over resources and reduce costs, with the assistance of the Serverless Stack (SST) framework. But here I got stuck! SST has no guide on how to deploy a turborepo ( I did it by tinkering ) and currently, I am stuck in using Prisma to create tables in AWS Aurora & then place them in the lambda layer.
Deployment Cost - AWS Aurora Database for 2 days cost me $0.35! with only 2 test users. It will become difficult for me to bear the cost of deployment.
## Features
1. Job referrals to top companies
2. Manage referrals requests
3. Easy apply to jobs referrals
4. Desktop App
5. Mobile App
## Getting Started
To get a local copy up and running, please follow these simple steps.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
### Prerequisites
Here is what you need to be able to run Cal.com.
- Node.js (Version: >=18.x)
- Git
- Docker and Docker Compose
- Yarn _(recommended)_
## Development
### Setup
1. Clone the repo into a public GitHub repository (or fork ). If you plan to distribute the code, keep the source code public to comply with [AGPLv3](https://github.com/sayandedotcom/refhired.com/blob/main/LICENSE).
```sh
git clone https://github.com/sayandedotcom/refhired.com
```
2. Go to the project folder
```sh
cd refhired.com
```
3. Install packages with yarn
```sh
yarn
```
4. Set up your `.env` file
- Duplicate `.env.example` to `.env`
- Use `openssl rand -base64 32` to generate a key and add it under `NEXTAUTH_SECRET` in the `.env` file.
5. Quick start with `yarn dx`
This will run the docker compose file in the root directory from the docker image build from @refhired.com/web on `http://localhost:3000/` and docker image build from @refhired.com/prisma (database) on `http://localhost:5432/` and adminar on `http://localhost:8080/`
> - **Requires Docker and Docker Compose to be installed**
```sh
yarn dx
```
6. Once your server has started, go to this url `http://localhost:3000/` and you will see the website running on a Development Server.
### License
-[MIT license](LICENSE)
### Contact 📬
For any query, email .
Thanks!