Skip to content

sayedmahmoud266/powerfulwebsites.space

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

46 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⚑ POWERFULWEBSITES.SPACE

Discover powerful but lesser-known websites that can transform your workflow

GitHub stars GitHub forks GitHub issues License

Buy Me A Coffee Live Demo React TypeScript

Curated tools, resources, and platforms you probably haven't heard of yet.

POWERFULWEBSITES.SPACE Screenshot

🌟 Features

  • 🎯 Curated Collection: Hand-picked powerful websites and tools across 20+ categories
  • πŸ” Advanced Search: Full-text search across names, descriptions, URLs, and tags with real-time results
  • 🏷️ Smart Filtering: Tag-based filtering with AND logic for precise results
  • 🎨 Interactive Cards: Beautiful, responsive website cards with optimized Cloudinary images
  • πŸ“± Responsive Design: Optimized for desktop, tablet, and mobile devices
  • ⚑ Performance Optimized: Fast loading with image optimization and lazy loading
  • 🎭 Dynamic UI: Particle background animations and smooth transitions
  • β™Ώ Accessibility: ARIA labels, keyboard navigation, and screen reader support
  • πŸ”— Rich Metadata: Detailed information with source links and contributor attribution
  • πŸŽͺ Modal Views: Expandable detailed views with comprehensive website information

πŸš€ Quick Start

Prerequisites

  • Node.js (version 18 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/sayedmahmoud266/powerfulwebsites.space.git
    cd powerfulwebsites.space
  2. Install dependencies

    npm install
  3. Start development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5173 to view the application

Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

πŸ›  Technology Stack

Frontend Framework

  • βš›οΈ React 18 - Modern UI library with hooks and concurrent features
  • πŸ“˜ TypeScript 5 - Type-safe JavaScript for enhanced developer experience
  • ⚑ Vite - Lightning-fast build tool and development server
  • 🎨 Tailwind CSS - Utility-first CSS framework for rapid styling

UI & Interactions

  • 🎯 Lucide React - Beautiful, customizable SVG icons
  • ✨ Custom Animations - Particle background and smooth transitions
  • πŸ“± Responsive Design - Mobile-first approach with breakpoint optimization
  • πŸŽͺ Modal System - Custom modal implementation with focus management

Image Optimization

  • ☁️ Cloudinary - Advanced image optimization and transformation
  • πŸ–ΌοΈ Responsive Images - Automatic format selection and sizing
  • ⚑ Lazy Loading - Performance-optimized image loading

Development & Quality

  • πŸ” ESLint - Code linting and quality assurance
  • 🎯 TypeScript - Static type checking and IntelliSense
  • πŸ“¦ Modern Bundling - Tree shaking and code splitting ready

πŸ“ Project Structure

powerfulwebsites.space/
β”œβ”€β”€ πŸ“‚ src/
β”‚   β”œβ”€β”€ 🧩 components/          # Reusable React components
β”‚   β”‚   β”œβ”€β”€ ParticleBackground.tsx   # Animated particle system
β”‚   β”‚   β”œβ”€β”€ SearchBar.tsx           # Real-time search component
β”‚   β”‚   β”œβ”€β”€ TagFilter.tsx           # Multi-select tag filtering
β”‚   β”‚   β”œβ”€β”€ WebsiteCard.tsx         # Website display cards
β”‚   β”‚   └── WebsiteModal.tsx        # Detailed website modals
β”‚   β”œβ”€β”€ πŸ—ƒοΈ data/               # Static data and configuration
β”‚   β”‚   └── websites.json           # Curated website database
β”‚   β”œβ”€β”€ πŸ”§ hooks/              # Custom React hooks
β”‚   β”‚   └── useViewport.ts          # Responsive viewport hook
β”‚   β”œβ”€β”€ πŸ› οΈ utils/              # Utility functions
β”‚   β”‚   └── cloudinary.ts           # Image optimization utilities
β”‚   β”œβ”€β”€ πŸ“± App.tsx            # Main application component
β”‚   β”œβ”€β”€ πŸš€ main.tsx           # Application entry point
β”‚   └── 🎨 index.css          # Global styles and fonts
β”œβ”€β”€ πŸ“š docs/                  # Comprehensive documentation
β”‚   β”œβ”€β”€ api/                        # API documentation
β”‚   β”œβ”€β”€ architecture/               # Architecture guides
β”‚   β”œβ”€β”€ components/                 # Component documentation
β”‚   β”œβ”€β”€ deployment/                 # Deployment guides
β”‚   β”œβ”€β”€ development/                # Development setup
β”‚   └── user-guide/                 # User documentation
β”œβ”€β”€ 🌐 public/               # Static assets
β”œβ”€β”€ πŸ“„ index.html           # HTML template
β”œβ”€β”€ πŸ“¦ package.json         # Dependencies and scripts
β”œβ”€β”€ 🎨 tailwind.config.js   # Tailwind CSS configuration
β”œβ”€β”€ ⚑ vite.config.ts       # Vite build configuration
└── πŸ“˜ tsconfig.json        # TypeScript configuration

🎨 Key Components

App Component

The main application component that orchestrates:

  • State management for websites, search, and filtering
  • Layout and responsive design
  • Modal management
  • Search and filter logic

WebsiteCard Component

Displays individual website information:

  • Website screenshot/image
  • Name, description, and tags
  • Metadata (added date, contributor)
  • Click-to-expand functionality
  • Accessibility features

SearchBar Component

Provides search functionality:

  • Real-time search input
  • Search query management
  • Responsive design

TagFilter Component

Enables tag-based filtering:

  • Multi-select tag filtering
  • Clear all functionality
  • Tag management and display

WebsiteModal Component

Detailed view component:

  • Full website information
  • Source links and metadata
  • Tag interaction
  • Responsive modal design

ParticleBackground Component

Animated background component:

  • Particle animation system
  • Performance optimized
  • Customizable parameters

πŸ” Search & Filtering

Search Capabilities

  • Full-text search across multiple fields
  • Real-time results as you type
  • Field-specific matching:
    • Website names
    • URLs
    • Descriptions
    • Tags

Tag Filtering

  • Multi-tag selection with AND logic
  • Visual tag indicators on cards
  • Filter persistence during search
  • Clear filters functionality

🎯 Data Structure

Website Object

interface Website {
  name: string;              // Website name
  url: string;               // Website URL
  icon_url?: string;         // Icon image URL
  screenshot_url?: string;   // Screenshot image URL
  tags_list: string[];       // Array of category tags
  description: string;       // Detailed description
  added_at: string;          // ISO date string
  added_by: {                // Contributor information
    user_alias: string;
    user_link: string;
  };
  sources: Array<{           // Source information
    source_url: string;
    url_metadata: {
      og_title: string;
      og_description: string;
      og_image?: string;
    };
  }>;
}

🎨 Styling & Design

Design System

  • Dark theme with accent colors
  • Orange accent color (#f97316) for branding
  • Gradient backgrounds and hover effects
  • Glass morphism effects with backdrop blur
  • Responsive grid layouts

Typography

  • Bungee font for headings
  • System fonts for body text
  • Responsive text sizing

Animations

  • Smooth transitions on hover and focus
  • Scale animations for interactive elements
  • Particle background animation
  • Loading states and skeleton screens

πŸ”§ Configuration

Vite Configuration

  • React plugin enabled
  • Lucide React excluded from dependency optimization

Tailwind Configuration

  • Standard content paths
  • No custom theme extensions
  • No additional plugins

TypeScript Configuration

  • Standard React TypeScript setup
  • App and Node configurations

πŸš€ Deployment

Live Demo

🌐 Visit POWERFULWEBSITES.SPACE - Experience the live application

Build Process

  1. Production Build
    npm run build
  2. Preview Build
    npm run preview
  3. Build Analysis
    npm run build -- --analyze

Deployment Platforms

  • πŸ”Ί Vercel (Current) - Zero-config deployment with automatic previews
  • 🌐 Netlify - Static site hosting with form handling
  • πŸ“„ GitHub Pages - Free hosting for public repositories
  • ☁️ Cloudflare Pages - Global CDN with edge computing

Performance Metrics

  • ⚑ Lighthouse Score: 95+ across all categories
  • πŸ“¦ Bundle Size: < 500KB gzipped
  • πŸ–ΌοΈ Image Optimization: Cloudinary integration
  • πŸ“± Mobile Performance: Optimized for all devices

🀝 Contributing

We welcome contributions! Here's how you can help make POWERFULWEBSITES.SPACE even better:

πŸš€ Quick Contribution

  1. ⭐ Star the repository to show your support
  2. 🍴 Fork the repository to your GitHub account
  3. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
  4. πŸ’Ύ Commit your changes (git commit -m 'Add amazing feature')
  5. πŸ“€ Push to the branch (git push origin feature/amazing-feature)
  6. πŸ”„ Open a Pull Request with a detailed description

🌐 Adding New Websites

  1. πŸ“ Edit src/data/websites.json
  2. πŸ“‹ Follow the data structure:
    {
      "name": "Website Name",
      "url": "https://example.com",
      "icon_url": "https://cloudinary-url/logo.png",
      "screenshot_url": "https://cloudinary-url/screenshot.jpg",
      "tags_list": ["Category", "Type"],
      "description": "Detailed description...",
      "added_at": "2025-01-01T00:00:00.000Z",
      "added_by": {
        "user_alias": "your-username",
        "user_link": "https://your-website.com"
      },
      "sources": []
    }
  3. 🏷️ Use appropriate tags from existing categories
  4. βœ… Test your addition locally before submitting

πŸ’» Code Style Guidelines

  • πŸ“˜ TypeScript for all new code
  • βš›οΈ Functional components with React hooks
  • 🎨 Tailwind CSS for styling
  • β™Ώ Accessibility features (ARIA labels, keyboard navigation)
  • πŸ“± Mobile-first responsive design
  • ⚑ Performance optimization considerations

πŸ› Bug Reports & Feature Requests

πŸ“± Browser Support

  • Modern browsers (Chrome 88+, Firefox 85+, Safari 14+, Edge 88+)
  • Mobile browsers with responsive design
  • Accessibility features for screen readers
  • Keyboard navigation support

πŸ” Security

  • Content Security Policy ready
  • HTTPS deployment recommended
  • External link security with rel="noopener noreferrer"
  • Image loading with error handling

πŸ“ˆ Performance

  • Vite for fast development and building
  • Lazy loading for images
  • Optimized animations with CSS transforms
  • Minimal bundle size with tree shaking
  • Efficient re-renders with React optimization

πŸ› Troubleshooting

Common Issues

Build fails

  • Ensure Node.js version 18+
  • Clear node_modules and reinstall

Styles not loading

  • Check Tailwind CSS installation
  • Verify content paths in config

TypeScript errors

  • Run npm run build to check types
  • Update TypeScript configuration

Modal not working

  • Check React component imports
  • Verify modal state management

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • βš›οΈ React Team - For the incredible framework that powers modern web development
  • ⚑ Vite Team - For the lightning-fast build tool and development experience
  • 🎨 Tailwind CSS - For the utility-first CSS framework that makes styling a joy
  • 🎯 Lucide React - For the beautiful, consistent icon library
  • ☁️ Cloudinary - For powerful image optimization and transformation
  • 🌐 Vercel - For seamless deployment and hosting
  • πŸ‘₯ Contributors - For making this project better with every contribution

πŸ“Š Project Stats

GitHub Stats

πŸ™ Support

If you find this project helpful, please consider:

  • ⭐ Starring the repository to show your support
  • 🍴 Forking and contributing to help it grow
  • β˜• Buying me a coffee to fuel development
  • 🐦 Sharing it with your network

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❀️ by sayedmahmoud266

Discover. Explore. Transform your workflow.

Visit Website

About

A curated, searchable directory of powerful but not widely-known websites. Built with modern web technologies, featuring a dark mode and a unique space-themed design.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors