Skip to content

gsnoopy/react-old-icons

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸชŸ React Old Icons

A comprehensive React component library featuring over 2,300 classic icons from vintage operating systems and software. Includes iconic designs from Windows 95, 98, XP, Vista, 7, classic games, and retro applications. Perfect for retro-themed applications, nostalgic UIs, and preserving digital history.

๐ŸŒ Interactive Icon Browser

๐Ÿ” Browse All Icons โ†’

Explore all 2,300+ icons with our interactive browser featuring search, filtering, and one-click code copying.

๐Ÿ“ฆ Installation

NPM Package: react-old-icons

npm install react-old-icons

๐Ÿš€ Usage

Import and use icons as React components with full TypeScript support:

import { 
  Windows7Calculator, 
  Games1nsane, 
  SoftwarePhotoshop,
  Windows95Notepad 
} from 'react-old-icons';

function App() {
  return (
    <div>
      {/* Basic usage */}
      <WindowsDesktopControlPanel size={32} />
      
      {/* With custom styling */}
      <DrvSpaceIcon 
        size={48} 
        className="my-icon" 
        style={{ margin: '10px' }} 
      />
      
      {/* Responsive sizing */}
      <WindowsRecycleBin size="2rem" />
      
      {/* With accessibility */}
      <Windows95Notepad 
        size={24} 
        alt="Classic Notepad icon" 
      />
    </div>
  );
}

๐Ÿ”ง Props

All icon components accept the following props:

Prop Type Default Description
size number | string 24 Icon size in pixels or CSS units
className string undefined CSS class name for styling
style React.CSSProperties undefined Inline styles object
alt string undefined Alt text for accessibility

๐Ÿ“š Available Icons

This library includes 2,300+ classic icons organized by categories:

  • ๐ŸŽฎ Games - Classic game icons (1nsane, AfterDark, Age of Empires, Counter-Strike, etc.)
  • ๐Ÿ’ป Software - Application icons (Photoshop, WinRAR, Media Player, Firefox, etc.)
  • ๐Ÿ–ฅ๏ธ System - System and utility icons from various operating systems
  • ๐ŸชŸ Windows Versions - OS-specific icons from Windows 95, 98, XP, Vista, 7

Icon Browser

Visit our Interactive Icon Browser to:

  • ๐Ÿ” Search through all available icons
  • ๐Ÿ“‹ Copy component code with one click
  • ๐Ÿ“ Filter by category
  • ๐Ÿ“ Preview different sizes
  • โŒจ๏ธ Use keyboard shortcuts for quick navigation

๐Ÿค Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute:

  • ๐Ÿ› Report bugs - Found an issue? Let us know!
  • ๐Ÿ’ก Suggest features - Have ideas for improvements?
  • ๐Ÿ“ Improve documentation - Help make our docs better
  • ๐ŸŽจ Add missing icons - Know of classic icons we missed?
  • ๐Ÿงน Code improvements - Optimize performance or add features
  • ๐Ÿท๏ธ Recategorize icons - Help improve icon categorization for better organization

Getting Started:

  1. Fork this repository
  2. Create a feature branch: git checkout -b feature/your-feature-name
  3. Make your changes and test them
  4. Submit a pull request with a clear description

Icon Contributions:

If you have classic icons from vintage software or operating systems to contribute:

  1. Ensure they're historically accurate and from the retro computing era
  2. Provide source information when possible
  3. Follow our naming conventions
  4. Include appropriate metadata

Icon Recategorization:

Feel free to contribute to better icon organization:

  1. Review the page/icons.jsonl file for categorization improvements
  2. Suggest more accurate categories for misclassified icons
  3. Propose new category structures that better reflect software history
  4. Help normalize icon names for improved searchability

โš–๏ธ Legal & Usage

๐Ÿ“‹ License

This project is licensed under the MIT License for the code and tooling.

๐Ÿšซ Commercial Use Restrictions

This library is intended for non-commercial, educational, and historical preservation purposes only.

๐Ÿข Icon Ownership

  • The icons in this collection are property of their respective companies
  • Microsoft Corporation owns Windows-related icons
  • Game developers and publishers own their respective game icons
  • Software companies own their application icons
  • Icons are used here for historical preservation and educational purposes

๐Ÿ“š Fair Use

This collection falls under fair use for:

  • Historical preservation of digital artifacts
  • Educational purposes about computing history
  • Non-commercial personal projects
  • Academic research and documentation

Please respect intellectual property rights and use responsibly.

๐Ÿ› ๏ธ Technical Implementation

This project was built using a comprehensive data pipeline and modern web technologies:

๐Ÿ”„ Data Collection & Processing

  • ๐Ÿ Web Scraping: Used Python with BeautifulSoup to systematically collect classic icons from sources
  • ๐Ÿค– AI Processing: Leveraged Ollama with Llama 3.1 8B locally for:
    • Converting original icon names into valid React component names
    • Intelligent categorization of icons by software type and era
    • Normalizing metadata for consistent search functionality

๐Ÿ–ผ๏ธ Image Processing Pipeline

  • ๐Ÿ“ Resizing: Python scripts using Pillow to standardize icon dimensions
  • ๐Ÿ—‚๏ธ Renaming: Automated file renaming to match component naming conventions
  • โšก WebP Conversion: Optimized all images to WebP format for superior web performance
  • ๐ŸŽฏ Cropping: Removed excess whitespace while preserving icon integrity

๐Ÿ’ป Technologies Used

Technology Purpose Badge
Python Web scraping, AI processing, image processing Core automation
Ollama Local LLM inference AI naming & categorization
TypeScript Component library development Type safety
JavaScript Interactive browser Icon preview
HTML5 Browser interface Structure
CSS3 Retro styling Presentation
Electron Desktop application Native app development
BeautifulSoup HTML parsing Web scraping
Pillow Image processing Optimization

๐ŸŒŸ Credits & Sources

Acknowledgments

  • ๐Ÿ™ Original creators - The designers and companies who created these iconic interfaces
  • ๐Ÿ“ฆ Old Windows Icons Tumblr - For preserving and cataloging these digital artifacts
  • ๐Ÿ›๏ธ Digital preservation community - For keeping computing history alive
  • ๐ŸŽจ Icon designers - Who created the visual language of early computing

Historical Significance

These icons represent an important era in computing history:

  • ๐Ÿ–ฅ๏ธ Early GUI development across different platforms (1990s-2000s)
  • ๐ŸŽฎ Golden age of PC gaming and iconic game designs
  • ๐Ÿ’ฟ Software packaging and branding evolution
  • ๐ŸŽจ Digital design language development across various applications

๐Ÿ›๏ธ Digital Preservation

This project serves as:

  • ๐Ÿ“š Historical archive of classic computer iconography
  • ๐ŸŽ“ Educational resource for design and computing history
  • ๐Ÿ” Research tool for UI/UX evolution studies
  • ๐Ÿ’พ Cultural preservation of digital heritage from various platforms

By preserving these icons, we maintain a visual record of how computer interfaces evolved across different operating systems and applications, influencing modern design.

๐Ÿ› ๏ธ Building from Source

# Clone the repository
git clone https://github.com/gsnoopy/react-old-icons.git
cd react-old-icons

# Install dependencies
npm install

# Generate icon components
npm run generate

# Build the library
npm run build

# Run tests
npm test

๐Ÿ“Š Project Stats

  • ๐Ÿ“ฆ 2,300+ icons across multiple categories
  • ๐Ÿท๏ธ TypeScript support with full type definitions
  • โšก Tree-shakeable - Only bundle icons you use
  • ๐Ÿ“ฑ Responsive - Works with any CSS unit
  • โ™ฟ Accessible - Screen reader friendly
  • ๐ŸŽจ Retro-authentic - Pixel-perfect historical accuracy

๐Ÿ“ž Support & Contact


๐Ÿ๏ธ In Memory

The favicon of this project features Johnny Castaway, the iconic screensaver character from the 1990s.

Rest in peace, Shawn Bird - the creative mind behind Johnny Castaway and many other digital experiences that defined an era of computing nostalgia.

About

React component library for vintage icons from classic games, software and operating systems

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published