https://github.com/joejo-joestar/joestar
🌐 my webisite :3
https://github.com/joejo-joestar/joestar
css github-api html javascript now-playing photo-gallery portfolio-website react spotify-web-api typescript unsplash-api
Last synced: 3 months ago
JSON representation
🌐 my webisite :3
- Host: GitHub
- URL: https://github.com/joejo-joestar/joestar
- Owner: joejo-joestar
- License: mit
- Created: 2025-06-03T19:50:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-04T12:45:57.000Z (4 months ago)
- Last Synced: 2026-04-15T12:44:09.488Z (3 months ago)
- Topics: css, github-api, html, javascript, now-playing, photo-gallery, portfolio-website, react, spotify-web-api, typescript, unsplash-api
- Language: TypeScript
- Homepage: https://joestar.is-a.dev
- Size: 3.81 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🌐 joestar
my portfolio website :3
to run this project locally, you need to have [Node.js](https://nodejs.org/) installed. And then run the following commands:
```bash
npm i
npm run dev
```
## 🙏 Special Thanks
- [Oneko](https://github.com/adryd325/oneko.js/) for cat follow mouse real!
- [nownownow.com](https://nownownow.com/about) for the "now" page
- [catppuccin](https://catppuccin.com/) for the color scheme
- [Emoji Kitchen](https://fonts.google.com/noto/specimen/Noto+Color+Emoji) for the remixed emojis (you can try out the combinations on this [really cool site](https://emojikitchen.dev/))
- [CSS Loaders](https://css-loaders.com/) for the loading animations
- [is-a.dev](https://is-a.dev/) for the free subdomain
---
## 🗂️ Project Structure
Below is a compact tree of the most important files and folders with a short note about their purpose.
```plaintext
joestar
├── eslint.config.js # ESLint rules and configuration
├── index.html # App HTML entry point
├── package.json # npm scripts, dependencies
├── README.md # Project documentation
├── tsconfig*.json # TypeScript configuration files
├── vercel.json # Vercel deployment configuration
├── vite.config.ts # Vite build/dev server config
├── public/ # Static assets served as-is
│ ├── oneko.gif # Oneko cat animation
│ ├── oneko.js # Oneko script used on the site
│ └── pixlogo.png # Logo image
└── src/ # Source code
├── catppuccin.css # Theme / color tokens
├── index.css # Global styles
├── main.tsx # React app bootstrap
├── oneko.ts # Oneko integration helper
├── vite-env.d.ts # Vite/TypeScript types
├── api/ # Small API clients and fetchers
│ ├── repos.ts # GitHub repo helpers
│ ├── spotify.ts # Spotify "now playing" client
│ └── unsplash.ts # Unsplash image fetcher
├── assets/ # Images used by the UI
│ ├── pix404.png
│ ├── pixcontact.png
│ ├── pixhi.png
│ ├── pixnow.png
│ ├── pixpics.png
│ └── pixprojects.png
├── components/ # Reusable UI components
│ ├── CategoryMenu/ # Category menu component
│ ├── Footer/ # Footer component
│ ├── MainGallery/ # Main gallery component
│ ├── Navbar/ # Navigation bar component
│ ├── NowPlaying/ # NowPlaying widget component
│ └── ProjectsList/ # Projects list component
├── hooks/ # Custom React hooks
│ ├── useHashPassword.tsx
│ ├── useMediaQuery.tsx
│ └── useScrollToTop.tsx
├── routes/ # Page routes (React Router)
│ ├── Contact/ # Contact page
│ ├── Home/ # Home page
│ ├── Missingno/ # 404 page
│ ├── Now/ # Now page
│ ├── Password/ # Password page
│ ├── Photos/ # Photos page
│ └── Projects/ # Projects page
└── shared/ # Shared utilities / data
└── socialsList.ts # Social links used across the site
```
---
## 🔌 Related Repos
This website uses resources from two other repos
- [joejo-joestar/joestar-middleware](https://github.com/joejo-joestar/joestar-middleware) for the api proxies
- [joejo-joestar/joestar-tools](https://github.com/joejo-joestar/joestar-tools) for the client side tools page
---
## 📋 Todo
Go to the linked [GitHiub Projects](https://github.com/users/joejo-joestar/projects/1/views/1) for a more flushed out "todo" list!