https://github.com/farzadasgari/folium
Professional developer portfolio boilerplate (React • TypeScript • Tailwind • Vite) with simple content customization.
https://github.com/farzadasgari/folium
cv-template frontend portfolio react responsive resume single-page-app tailwindcss template typescript vite webapp
Last synced: 22 days ago
JSON representation
Professional developer portfolio boilerplate (React • TypeScript • Tailwind • Vite) with simple content customization.
- Host: GitHub
- URL: https://github.com/farzadasgari/folium
- Owner: farzadasgari
- License: mit
- Created: 2025-07-21T14:05:38.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-03T14:14:19.000Z (10 months ago)
- Last Synced: 2025-09-03T16:18:56.844Z (10 months ago)
- Topics: cv-template, frontend, portfolio, react, responsive, resume, single-page-app, tailwindcss, template, typescript, vite, webapp
- Language: TypeScript
- Homepage: https://farzadasgari.github.io/folium/
- Size: 2.48 MB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# A Responsive React-TS + Tailwind Portfolio Template
[](https://github.com/farzadasgari/folium/blob/main/LICENSE)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](https://tailwindcss.com/)
[](https://farzadasgari.github.io/folium)
A modern, responsive portfolio template built with **React**, **TypeScript**, and **Tailwind CSS**. This template helps developers quickly create a professional portfolio to showcase projects, skills, and experience. Fully responsive and customizable, it works seamlessly across desktop, tablet, and mobile devices.
---
## Table of Contents
- [Features](#features)
- [Live Demo](#live-demo)
- [Installation](#installation)
- [Usage](#usage)
- [Customization](#customization)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
---
## Features
- 🌐 **Responsive Design**: Adapts to all screen sizes for a consistent user experience.
- 🛠️ **Modern Tech Stack**: Built with React, TypeScript, and Tailwind CSS for scalability and maintainability.
- 🎨 **Customizable**: Easily edit themes, colors, and content to match your personal brand.
- ⚡ **Quick Setup**: Start fast with clear instructions and a clean structure.
- 🚀 **GitHub Pages Ready**: Deploy your portfolio in minutes.
- 🌙 **Theme Modes**: Toggle between light, dark, and custom themes for a modern look.
- ✨ **Animated Transitions**: Smooth page transitions for a polished user experience.
- 🔍 **SEO Optimized**: Structured for better discoverability on search engines.
- 📂 **Easy Project Integration**: Add or edit projects via a single data file.
---
## Live Demo
See the template in action:
🚀 **[View Live Demo](https://farzadasgari.github.io/folium)**
---
## Installation
To get started:
1. **Clone the Repository**
```bash
git clone https://github.com/farzadasgari/folium.git
cd folium
```
2. **Install Dependencies**
Ensure you have Node.js (v18+) and npm.
```bash
npm install
```
---
## Usage
To run locally:
1. **Start Development Server**
```bash
npm run dev
```
Visit [http://localhost:5173](http://localhost:5173) in your browser.
2. **Build for Production**
```bash
npm run build
```
The optimized output is in the `build/` folder.
---
## Customization
Make the portfolio your own:
### Content
Edit to update sections like About, Projects, Skills, and Contact.
### Styling
Modify theme settings or directly use Tailwind CSS classes in components.
### Assets
Replace images in `public/` (e.g., profile photo, project thumbnails) with your own.
---
## Contributing
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature/your-feature
```
3. Make your changes and commit:
```bash
git commit -m "Add your feature"
```
4. Push to your branch:
```bash
git push origin feature/your-feature
```
5. Open a Pull Request.
See full guidline at [CONTRIBUTING](https://github.com/farzadasgari/folium/blob/main/CONTRIBUTING.md)
---
## License
This project is licensed under the MIT License. See the [LICENSE](https://github.com/farzadasgari/folium/blob/main/LICENSE) file for details.
---
## Contact
For any inquiries, please contact:
- std_farzad.asgari@khu.ac.ir
- khufarzadasgari@gmail.com
---
## Links
[](https://farzadasgari.ir/)
[](https://scholar.google.com/citations?user=Rhue_kkAAAAJ&hl=en)
[](https://www.researchgate.net/profile/Farzad-Asgari)
[](https://www.linkedin.com/in/farzad-asgari/)
[](https://x.com/farzad_asg)
---
## Support & Donations
If you find this template useful, please consider supporting development:
**💸 Crypto Donations**
- Bitcoin: `bc1qxd8um2jre6xz4je64uhar9eh9uzu9yrvzh08sm`
- Ethereum: `0xCc8693060409263F68e37f75f76d519c19B2bAdE`
- USDT (TRC20): `TLL9ou7PahrNob2GEppV3o4e5B9vYqgsJN`
**🌐 Donate via CoinDrop**
---