AkshayKalapgar.com - v1

The first iteration of AkshayKalapgar.com, built with Next.js and hosted on Vercel.

---

🚀 About This Repository

I’m excited to see my portfolio gaining traction, inspiring developers worldwide. This repository contains the full source code for my website, which you’re welcome to use for your own projects. If you do, a credit link back would be greatly appreciated! 😊

🔥 Unique Features

• Fully responsive design built with Tailwind CSS
• Framer Motion animations for smooth transitions
• Next.js for optimal SEO and performance
• Custom "This website can't be reached" trick for a playful user experience
• Open-source with a modular and scalable structure

Note: While some design inspiration comes from Anaflous Abdellatif’s portfolio, all code has been written from scratch.

---

📌 Table of Contents

• Description
• Technologies & Libraries
• Installation & Setup
• Building for Production
• API Endpoints
• Color Palette
• License
• Author

---

📝 Description

This portfolio serves as a personal space to showcase my projects, skills, and experience. I chose Next.js for its server-side rendering (SSR), which enhances SEO and improves page load times. Styling is managed with Tailwind CSS, ensuring a visually appealing, responsive layout with minimal effort.

---

💡 Technologies & Libraries

This project utilizes the following tools and libraries:

• Next.js (React Framework)
• TypeScript (Strongly typed JavaScript)
• Tailwind CSS (Utility-first styling)
• Framer Motion (Smooth animations)
• Google API (Geolocation services)
• Node.js (Backend functionalities)
• Vercel Analytics (Performance monitoring)

For additional dependencies, refer to the package.json file.

Sponsor Me

If you appreciate my work, consider sponsoring me on GitHub!

[Sponsor]

---

🛠 Installation & Setup

To run this project locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/Akkikens/akshay-portfolio.git

2. Install Node.js via NVM (Recommended):

   nvm install

3. Install dependencies:

   yarn

4. (Optional): Create a .env file for environment variables:

   touch .env

5. (Optional): Add your Google API key inside .env:

   NEXT_PUBLIC_KEY_GOOGLE_API="your-api-key"

   Note: Not adding a Google API key may cause incorrect or missing zip codes in the geolocation service.

6. Start the development server:

   yarn dev

---

🚀 Building for Production

To generate and preview the production build:

1. Generate a static build:

   yarn build

2. Preview the site before deployment:

   yarn run serve

---

🔗 API Endpoints

📍 Endpoint 1: Get User Info by IP

Returns a JSON object with details about the provided IP address.

/api/userInfoByIP/[IP-Address]

Example:

/api/userInfoByIP/159.89.173.104

Response:

{
  "zip": "560002",
  "country": "India",
  "city": "Bengaluru",
  "isp": "DigitalOcean, LLC",
  "timezone": "Asia/Kolkata"
}

📍 Endpoint 2: Get Zip Code by Latitude & Longitude

Returns the postal code for the given coordinates.

/api/userInfoByLatLon/[lat]/[lon]

Example:

/api/userInfoByLatLon/12.9634/77.5855

Response:

{"zipcode": "56998"}

📍 Endpoint 3: Get a Random Quote

Returns a random quote based on a specified minimum character length.

/api/typing/[minLength]

Notes:

• minLength must be between 10 and 300.
• This is a customized endpoint using Next.js API routes.

---

🎨 Color Palette

Color	Hex Code
Navy	#0a192f
Light Navy	#112240
Slate	#8892b0
Green	#64ffda
White	#e6f1ff

---

📜 License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2024 Akshay Kalapgar

Permission is hereby granted, free of charge, to use, copy, modify, and distribute this software.

---

👨‍💻 Author

• LinkedIn: @Akshay-Kalapgar
• Website: AkshayKalapgar.com

🔝 Back to Top