An open API service indexing awesome lists of open source software.

https://github.com/5h1ngy/fe-react-portfolio

A modern React-based portfolio showcasing projects, skills, and achievements with support for Storybook and Chakra UI.
https://github.com/5h1ngy/fe-react-portfolio

chakra-ui developer-portfolio frontend modern-design portfolio react react-components storybook typescript vite

Last synced: 6 months ago
JSON representation

A modern React-based portfolio showcasing projects, skills, and achievements with support for Storybook and Chakra UI.

Awesome Lists containing this project

README

          

# **FE-React-Portfolio**


logo

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Version](https://img.shields.io/badge/version-1.0.0-blue)](#)
![Node.js](https://img.shields.io/badge/node-%3E%3D20.18.0-green)
![Yarn](https://img.shields.io/badge/yarn-%3E%3D4.5.1-green)

A modern portfolio application built using **React**, **TypeScript**, and **Chakra-UI**, showcasing modular design, theming capabilities, and reusable components. Designed for scalability and optimal developer experience.



Preview Desktop Light
Preview Mobile Light
Preview Desktop Dark
Preview Mobile Dark

## **Table of Contents ๐Ÿงญ**
- [URLs ๐ŸŒ](#urls-)
- [Introduction ๐Ÿค”](#introduction-)
- [Features โœจ](#features-)
- [Requirements ๐Ÿ](#requirements-)
- [Build Process ๐Ÿญ](#build-process-)
- [Usage ๐Ÿ’ป](#usage-)
- [Project Structure ๐Ÿ—](#project-structure-)
- [Key Dependencies ๐Ÿ”‘](#key-dependencies-)
- [Testing ๐Ÿงช](#testing-)
- [License ๐Ÿ“œ](#license-)
- [Contributing ๐Ÿค](#contributing-)
- [Contact ๐Ÿ“ซ](#contact-)

## **URLs ๐ŸŒ**

| Key | Value |
|------|----------------------------------------------------------------|
| Site | [https://5h1ngy.github.io/fe-react-portfolio/home](#) |

## **Introduction ๐Ÿค”**

**FE-React-Portfolio** is a modular, themeable portfolio application designed to showcase projects, skills, and professional information. It leverages modern frontend technologies and integrates seamlessly with libraries such as **GSAP** for animations and **Redux Toolkit** for state management.

## **Features โœจ**
- **Responsive design** with light/dark themes.
- **Interactive project showcase** with animations (powered by GSAP).
- **Modular component-based** structure for reusability.
- **Built-in Markdown rendering** for project descriptions.
- **Type-safe** development using **TypeScript**.
- **State management** with **Redux Toolkit**.

## **Requirements ๐Ÿ**
- **Node.js**: `>= 20.18.0`
- **Yarn**: `>= 4.5.1`

## **Build Process ๐Ÿญ**
- **Production build**:
```bash
yarn build:prod
```
- **Production preview**:
```bash
yarn preview:prod
```

## **Usage ๐Ÿ’ป**

- **Project Showcase**: Interactive cards displaying project details, links, and thumbnails.
- **Markdown Support**: Render project descriptions dynamically using Markdown.
- **Dark Mode**: Built-in light/dark theme toggling via Chakra UI.
- **Animations**: Smooth page transitions and interactive elements with GSAP.

> **Note**: Since this is a frontend application, please see your preferred deployment guide or host to run the compiled project in a production environment.

## **Project Structure ๐Ÿ—**

```plaintext
src/
โ”œโ”€โ”€ assets/ # Static assets (images, icons, etc.)
โ”œโ”€โ”€ components/ # Reusable components
โ”œโ”€โ”€ hocs/ # Higher-order components
โ”œโ”€โ”€ pages/ # Page-level components (Home, About, etc.)
โ”œโ”€โ”€ services/ # API calls, data fetching, etc.
โ”œโ”€โ”€ store/ # Redux state slices and async thunks
โ”œโ”€โ”€ styles/ # Global styles or theming config
โ”œโ”€โ”€ utils/ # Helper functions and utilities
โ”œโ”€โ”€ App.tsx # Main app entry point
โ””โ”€โ”€ main.tsx # Application bootstrap file
```

## **Key Dependencies ๐Ÿ”‘**
- **React** (v19.x)
- **TypeScript** (v5.x)
- **Chakra-UI** (v3.x)
- **Redux Toolkit** (v2.x)
- **GSAP** (v3.x)

## **Testing ๐Ÿงช**

Run your **unit tests** with:

```bash
yarn test
```

## **License ๐Ÿ“œ**
This project is licensed under the [MIT License](./LICENSE).

## **Contributing ๐Ÿค**
1. **Fork** the repository or open a new branch in your local clone.
2. Make your changes in the dedicated folder or file.
3. Open a **pull request** describing your changes.

## **Contact ๐Ÿ“ซ**
- **Author**: [5h1ngy](https://github.com/5h1ngy)
- **Repository**: [GitHub](https://github.com/5h1ngy/fe-react-portfolio)