https://github.com/pumukydev/pumukydev.com
A self-updating portfolio powered by Flask and HTMX, including a whoami section, experience timeline, and a dynamic list of top-ranked GitHub project
https://github.com/pumukydev/pumukydev.com
css docker flask htmx personal-site portfolio python
Last synced: 3 months ago
JSON representation
A self-updating portfolio powered by Flask and HTMX, including a whoami section, experience timeline, and a dynamic list of top-ranked GitHub project
- Host: GitHub
- URL: https://github.com/pumukydev/pumukydev.com
- Owner: PumukyDev
- License: mit
- Created: 2025-05-23T11:21:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-12T09:42:55.000Z (about 1 year ago)
- Last Synced: 2025-06-12T10:37:10.880Z (about 1 year ago)
- Topics: css, docker, flask, htmx, personal-site, portfolio, python
- Language: HTML
- Homepage: https://pumukydev.com/
- Size: 1.85 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pumukydev.com
## 📦 Requirements
- [Docker](https://www.docker.com/)
- [Docker Compose](https://docs.docker.com/compose/)
## 🛠️ Setup Instructions
### 1. Clone the repository
```bash
git clone https://github.com/PumukyDev/pumukydev.com.git
cd pumukydev.com
```
### 2. Configure the web
1. Copy the environment file:
```bash
cp ./app/.env.example ./app/.env
```
2. Edit the `.env` file:
- Add your **GitHub token** (you can generate one [here](https://github.com/settings/tokens)). It only needs `public_repo` permissions.
- Add your **GitHub username**.
3. Replace the content in `/app/templates/index.html` and `/app/data/experience.json` to reflect your own professional experience and personal info.
4. To exclude any of your repositories from being shown, list their names in `/app/blacklist.txt`.
### 3. Deploy the server
```bash
docker-compose up -d --build
```
### 4. See the web
Visit [http://localhost:8000](http://localhost:8000)
If you want to deploy it publicly, check this guide where I explain how to self-host it:
👉 [https://github.com/PumukyDev/self-hosting](https://github.com/PumukyDev/self-hosting)
## 🔁 Fork this project
If this template was useful to you:
- Fork it and make it your own
- Replace the content with your personal data
- Don’t forget to **mention** `@PumukyDev` if you use or get inspired by it — I’d love to see your version!
- Contributions and stars are always welcome 🤍
## 📄 License
This project is open-source and available under the [MIT License](LICENSE).