KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

portfolio_v2

★ 53 Open GitHub ↗

Checkout it live here 👇

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Taqui - My Portfolio ✨

Welcome to the source code for my personal portfolio website! This project showcases my skills, projects, and experience using a modern tech stack. The site is designed to be clean, responsive, and engaging.

[![Next.js](https://img.shields.io/badge/Next.js-v15-blue?style=flat-square)](https://nextjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-blue?style=flat-square)](https://www.typescriptlang.org/)
[![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-v4-purple?style=flat-square)](https://tailwindcss.com/)
[![Vercel](https://img.shields.io/badge/Vercel-black?logo=vercel&logoColor=white&style=flat-square)](https://vercel.com/)

**[Live Demo](https://taqui-imam.vercel.app/)**

## Features 🚀

- **Responsive Design:**  The portfolio adapts seamlessly to various screen sizes, ensuring a consistent user experience across desktops, tablets, and mobile devices.
- **Dark Mode:**  Users can easily switch between light and dark themes to match their preferences.
- **Interactive Profile:** A visually appealing profile section includes an image and an animated text flipper showcasing the developer's roles.
- **Experience & Projects:**  Collapsible accordions provide detailed information about the developer's experience and projects.  Each project includes links to the GitHub repository and live demo (where available).
- **Contact Form:** A user-friendly contact form allows visitors to easily reach out.  The form uses Nodemailer to send emails directly to the developer's inbox.  **Note:**  This requires setting up SMTP credentials (see Installation).
- **Social Links:**  Conveniently access the developer's social media profiles.

## Tech Stack 🛠️

- **Framework:** Next.js 15
- **Language:** TypeScript
- **Styling:** Tailwind CSS
- **UI Components:** Shadcn UI, Radix UI
- **Animations:** Framer Motion
- **Form Handling:** React Hook Form, Zod
- **Email:** Nodemailer
- **Deployment:** Vercel

## Installation & Setup 💻

1. **Clone the repository:**
```bash
git clone https://github.com/taqui-786/Taqui.git
```
cd Taqui

```bash
2. **Install dependencies:**
   ```bash
npm install
   ```

3. **Set up environment variables:**
   Create a `.env.local` file in the project root and add your SMTP credentials for the contact form:
```env
SMPT_HOST="your-smtp-host"
SMPT_USER="your-smtp-user"
SMPT_PASS="your-smtp-password"
```

4. **Run the development server:**
```bash
npm run dev
   ```

Open [http://localhost:3000](http://localhost:3000) in your browser.

## Usage Examples 💡

The code utilizes several key libraries:

- **React Hook Form:**  Manages form state and validation in the Contact Me section (`src/components/sections/ContactMeSection.tsx`).
- **Zod:** Provides schema validation for the contact form data.
- **Next-Themes:** Enables the dark/light theme switching functionality (`src/components/ThemeProvider.tsx`).
- **Nodemailer:** Handles sending emails from the contact form (`src/components/sections/ContactMeSection.tsx` and `src/lib/mailConfiguration.ts`).
- **Shadcn UI:** Provides pre-built UI components for a consistent design.
- **Framer Motion:**  Used for animations (e.g., the profile section's text flipper).

## Contributing 🤝

Contributions are welcome! Please open an issue or submit a pull request.

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them with clear messages.
4. Push your branch to your forked repository.
5. Submit a pull request to the main repository.

## License 📄

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

portfolio_v2

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README