🌐 joestar

my portfolio website :3

to run this project locally, you need to have Node.js installed. And then run the following commands:

npm i
npm run dev

🙏 Special Thanks

• Oneko for cat follow mouse real!
• nownownow.com for the "now" page
• catppuccin for the color scheme
• Emoji Kitchen for the remixed emojis (you can try out the combinations on this really cool site)
• CSS Loaders for the loading animations
• 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.

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 for the api proxies
• joejo-joestar/joestar-tools for the client side tools page

---

📋 Todo

Go to the linked GitHiub Projects for a more flushed out "todo" list!