Skip to content

Commit c268c9a

Browse files
authored
Merge pull request #73 from binhtran432k/docs/readme
docs(readme): update details
2 parents 084b8b9 + 55c4b01 commit c268c9a

File tree

1 file changed

+70
-19
lines changed

1 file changed

+70
-19
lines changed

README.md

Lines changed: 70 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,79 @@
1-
# binhtran432k.github.io
1+
# My Personal Portfolio
22

3-
To install dependencies:
3+
Welcome to the repository for my **Personal Portfolio**! This project serves as
4+
my personal website, showcasing my work, skills, and background. It’s a
5+
minimalist, self-built solution designed to focus on efficiency, performance,
6+
and creativity.
47

5-
```bash
6-
bun install
7-
```
8+
## Features
89

9-
To build the website:
10+
### Built with Simplicity and Efficiency
1011

11-
```bash
12-
bun run build
13-
```
12+
- **Internal Static Site Generator (SSG):** Custom-built on top of **[Van
13+
JS](https://vanjs.org/)** to minimize dependencies and build tools.
14+
- **[Bun](https://bun.sh/):** Used to minify JavaScript and CSS for faster load
15+
times and to run the local development server efficiently.
1416

15-
To build the website in watch mode (use with preview):
17+
### Styling and Effects
1618

17-
```bash
18-
bun build:watch
19-
```
19+
- **Pure CSS:** No frameworks—just clean, handcrafted styles for optimal
20+
performance and aesthetics.
21+
- **WebGL:** Used for fancy 2D image effects with shaders, creating dynamic and
22+
visually appealing motion without third-party plugins or libraries.
2023

21-
To preview the website:
24+
### Seamless Deployment
2225

23-
```bash
24-
bun preview
25-
```
26+
- **GitHub Actions:** Automated CI/CD pipeline to build and deploy the
27+
portfolio to GitHub Pages, ensuring every update goes live effortlessly.
2628

27-
This project was created using `bun init` in bun v1.1.31. [Bun](https://bun.sh)
28-
is a fast all-in-one JavaScript runtime.
29+
### Pages
30+
31+
- **Homepage (`/`):** Introduces me, my work, and my interests in a simple yet
32+
elegant layout [[link](https://binhtran432k.com)].
33+
- **Resume Page (`/resume`):** Dedicated page to showcase my detailed resume
34+
[[link](https://binhtran432k.com/resume)].
35+
36+
## Why Build This?
37+
38+
This project is a reflection of my skills and philosophy as a developer. By
39+
using self-built tools and minimal third-party dependencies, I aim to create a
40+
site that is:
41+
42+
- Lightweight and fast.
43+
- Easy to maintain.
44+
- Fully customized to represent my personal style.
45+
46+
## Getting Started
47+
48+
1. Clone the repository:
49+
50+
```bash
51+
git clone https://github.com/binhtran432k/binhtran432k.github.io.git
52+
```
53+
54+
1. Run the development server or just build it:
55+
56+
```bash
57+
# for development
58+
bun run preview
59+
# for build only
60+
bun run build
61+
```
62+
63+
## What's Inside?
64+
65+
This repository contains:
66+
67+
- **Custom SSG** for building the portfolio.
68+
- **CSS styles** for the entire site.
69+
- **WebGL effects** for fancy 2D image effects.
70+
- **Resume page** with detailed information about my professional background.
71+
72+
## Contributing
73+
74+
While this is a personal project, feel free to explore the code and offer
75+
suggestions by opening an issue or a pull request.
76+
77+
---
78+
79+
Thank you for visiting my portfolio repository! 🚀

0 commit comments

Comments
 (0)