generated from CodeChefVIT/template
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
46 changed files
with
140 additions
and
76 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,37 +1,7 @@ | ||
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files. | ||
# Editor | ||
.vscode | ||
.idea | ||
|
||
# dependencies | ||
/node_modules | ||
/.pnp | ||
.pnp.js | ||
.yarn/install-state.gz | ||
|
||
# testing | ||
/coverage | ||
|
||
# next.js | ||
/.next/ | ||
/out/ | ||
|
||
# production | ||
/build | ||
|
||
# misc | ||
.DS_Store | ||
*.pem | ||
|
||
# debug | ||
npm-debug.log* | ||
yarn-debug.log* | ||
yarn-error.log* | ||
|
||
# local env files | ||
# Environment | ||
.env | ||
.env*.local | ||
|
||
# vercel | ||
.vercel | ||
|
||
# typescript | ||
*.tsbuildinfo | ||
next-env.d.ts | ||
.DS_Store |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,63 +1,120 @@ | ||
# Contact File Service | ||
<p align="center"><a href="https://www.codechefvit.com" target="_blank"><img src="https://i.ibb.co/4J9LXxS/cclogo.png" width=160 title="CodeChef-VIT" alt="Codechef-VIT"></a> | ||
</p> | ||
|
||
The Contact File Service offers a seamless solution for users to upload contact information in various formats (CSV, XLSX, or XLS). Upon submission, the backend processes this data, extracting details such as names, phone numbers, emails, and genders. It compiles this information into a unified contact file (VCF file) compatible with Android and iOS devices, simplifying contact management. | ||
<h2 align="center">Contactify</h2> | ||
<br/> | ||
|
||
## Features | ||
> <p>The Contact File Service offers a seamless solution for users to upload contact information in various formats (CSV, XLSX, or XLS). Upon submission, the backend processes this data, extracting details such as names, phone numbers, emails, and genders. It compiles this information into a unified contact file (VCF file) compatible with Android and iOS devices, simplifying contact management.</p> | ||
## 🌐 Deploy | ||
|
||
[https://contactify.codechefvit.com/](https://contactify.codechefvit.com/) | ||
|
||
## ⚙️ Tech Stack: | ||
|
||
- Next.js | ||
- TypeScript | ||
- Tailwind CSS | ||
|
||
## 🖼 Screenshots | ||
|
||
<p align="center"> | ||
</p> | ||
|
||
## 🏁 Get Started | ||
|
||
Follow these steps to set up and run the Contact File Backend Service locally: | ||
|
||
1. Local Installation | ||
|
||
1. **Clone the Repository** | ||
|
||
- Clone the repository. | ||
```bash | ||
git clone https://github.com/CodeChefVIT/contactify-fe.git | ||
``` | ||
- Navigate to the cloned directory and run | ||
```bash | ||
cd contactify-fe | ||
``` | ||
|
||
2. **Install Dependencies** | ||
|
||
- Install all required dependencies for running the server on local machine | ||
```bash | ||
npm install | ||
``` | ||
|
||
3. **Configuration** | ||
|
||
- Create a `.env` file in the root directory. | ||
- Define environment variables as in `.env.example`. | ||
|
||
4. **Build the website** | ||
```bash | ||
npm run build | ||
``` | ||
5. **Start the Server** | ||
- Start the server using | ||
```bash | ||
npm start | ||
``` | ||
- The service will be running on `http://localhost:3000` by default. | ||
|
||
2. Backend Installation | ||
- Follow the steps on https://github.com/CodeChefVIT/contactify-backend to set up the backend service. | ||
|
||
## ✨ Features | ||
|
||
### File Upload Prompt | ||
|
||
- Enables users to upload contact files in various formats (CSV, XLSX, XLS) effortlessly. | ||
|
||
### Automatic Header Extraction | ||
|
||
- Identifies and extracts headers from uploaded files to assist in contact data organization. | ||
|
||
### Header Mapping Interface | ||
|
||
- Provides a user-friendly interface for mapping extracted headers to predefined contact fields like first name, middle name, last name, gender, phone number, and email for accurate data categorization. | ||
|
||
### Custom Data Handling Options | ||
|
||
- **Row Filtering**: Allows skipping rows without a phone number or with insufficient phone number digits. | ||
- **Data Validation**: Offers options to set criteria for data inclusion, ensuring accuracy and completeness. | ||
|
||
### Contact File Generation Options | ||
|
||
- **Unified VCF File**: Generates a single VCF file containing all organized contact information. | ||
- **Individual Contact Files**: Provides flexibility to receive contacts as separate files bundled together in a convenient zip format. | ||
|
||
## Installation Guide | ||
## 📝 Checkout: | ||
|
||
Follow these steps to set up and run the Contact File Backend Service locally: | ||
- Contactify Backend: [https://github.com/CodeChefVIT/contactify-backend](https://github.com/CodeChefVIT/contactify-backend) | ||
|
||
1. Local Installation | ||
## 🚀 Contributors | ||
|
||
1. **Clone the Repository** | ||
- Clone the repository. | ||
```bash | ||
git clone https://github.com/CodeChefVIT/contactify-fe.git | ||
``` | ||
- Navigate to the cloned directory and run | ||
```bash | ||
cd contactify-fe | ||
``` | ||
|
||
2. **Install Dependencies** | ||
- Install all required dependencies for running the server on local machine | ||
```bash | ||
npm install | ||
``` | ||
|
||
3. **Configuration** | ||
- Create a `.env` file in the root directory. | ||
- Define environment variables as in `.env.example`. | ||
|
||
4. **Build the website** | ||
```bash | ||
npm run build | ||
``` | ||
|
||
5. **Start the Server** | ||
- Start the server using | ||
```bash | ||
npm start | ||
``` | ||
- The service will be running on `http://localhost:3000` by default. | ||
|
||
2. Backend Installation | ||
- Follow the steps on https://github.com/CodeChefVIT/contactify-backend to set up the backend service. | ||
<table> | ||
<tr align="center"> | ||
<td> | ||
<p align="center"> | ||
<img src = "https://avatars.githubusercontent.com/u/91564450?v=4" width="200" height="200" alt="profilepic" style="border: 2px solid grey; width: 170px; height:170px"> | ||
</p> | ||
<p style="font-size:17px; font-weight:600;">Aaditya Mahanta</p> | ||
<p align="center"> | ||
<a href = "https://github.com/aditansh"><img src = "http://www.iconninja.com/files/241/825/211/round-collaboration-social-github-code-circle-network-icon.svg" width="36" height = "36" alt="GitHub"/></a> | ||
<a href = "https://www.linkedin.com/in/aadityamahanta/"> | ||
<img src = "http://www.iconninja.com/files/863/607/751/network-linkedin-social-connection-circular-circle-media-icon.svg" width="36" height="36" alt="LinkedIn"/> | ||
</a> | ||
</p> | ||
</td> | ||
</tr> | ||
</table> | ||
|
||
## License | ||
|
||
[![License](http://img.shields.io/:license-mit-blue.svg?style=flat-square)](http://badges.mit-license.org) | ||
|
||
<p align="center"> | ||
Made with :heart: by <a href="https://www.codechefvit.com" target="_blank">CodeChef-VIT</a> | ||
</p> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
NEXT_PUBLIC_API_URL=https://backend-url.com/api |
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files. | ||
|
||
# dependencies | ||
/node_modules | ||
/.pnp | ||
.pnp.js | ||
.yarn/install-state.gz | ||
|
||
# testing | ||
/coverage | ||
|
||
# next.js | ||
/.next/ | ||
/out/ | ||
|
||
# production | ||
/build | ||
|
||
# misc | ||
.DS_Store | ||
*.pem | ||
|
||
# debug | ||
npm-debug.log* | ||
yarn-debug.log* | ||
yarn-error.log* | ||
|
||
# local env files | ||
.env | ||
.env*.local | ||
|
||
# vercel | ||
.vercel | ||
|
||
# typescript | ||
*.tsbuildinfo | ||
next-env.d.ts |
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.