🎁 AI Tools Collection - Open Source

A curated collection of powerful AI tools, maintained by the community. This project welcomes contributions from developers worldwide to help build the most comprehensive AI tools directory.

🌟 Features

• Curated AI Tools: Hand-picked collection of the best free AI tools
• Community Driven: Open for contributions from anyone
• Responsive Design: Works perfectly on all devices
• Easy Navigation: Organized by categories for quick discovery
• Search & Filter: Find tools quickly with built-in search functionality
• Analytics Tracking: Usage insights with Google Analytics

🚀 Live Demo

Visit the live website: AI Tools Collection

📊 Current Stats

• 100+ Free AI Tools
• 10 Categories
• Open Source & Community Maintained
• 15+ Active Contributors

🤝 How to Contribute

We welcome contributions from everyone! Here's how you can help improve this project:

Adding New AI Tools

1. Fork this repository

2. Clone your fork locally

   git clone https://github.com/YOUR_USERNAME/ai-tools-manager.git
   cd ai-tools-manager

3. Add your tool to links.json

   • Find the appropriate category or create a new one
   • Add your tool following this format:

   {
     "title": "Tool Name",
     "url": "https://tool-website.com",
     "description": "Brief description of what the tool does"
   }

4. Add yourself as a contributor (see below)

5. Test your changes

   • Open index.html in your browser
   • Verify your tool appears correctly
   • Check that the link works

6. Submit a Pull Request

   • Create a descriptive title
   • Explain what tool you added and why it's valuable
   • Include any relevant screenshots

Adding Yourself as a Contributor

When you contribute, add yourself to the contributors list:

1. Add your information to contributors.json:

   {
     "name": "Your Name",
     "github": "your-github-username",
     "avatar": "https://github.com/your-username.png",
     "contributions": ["Added Tool Name", "Fixed bug in category X"],
     "website": "https://your-website.com" // optional
   }

2. Your profile will automatically appear in the contributors section

📁 Project Structure

ai-tools-collection/
├── index.html              # Main HTML file
├── style.css               # Styling and animations
├── script.js               # JavaScript functionality
├── links.json              # AI tools database
├── contributors.json       # Contributors database
├── manifest.json           # PWA manifest
├── package.json            # Project configuration
├── README.md               # This file
├── CONTRIBUTING.md         # Contribution guidelines
├── COMMIT_GUIDELINES.md    # Commit message standards
├── CONTRIBUTOR_EXAMPLE.md  # Contributor profile template
├── assets/                 # Project assets
│   ├── favicon.svg         # Site favicon
│   ├── og-image.svg        # Social media image
│   └── README.md           # Assets documentation
├── src/                    # Source files
│   ├── assets/             # Additional assets
│   ├── scripts/            # JavaScript modules
│   └── templates/          # HTML templates
└── tests/                  # Test files
    ├── integration/        # Integration tests
    └── unit/               # Unit tests

🛠️ Development Setup

1. Clone the repository

   git clone https://github.com/ArshdeepGrover/ai-tools-collection.git
   cd ai-tools-collection

2. Install dependencies (optional)

   npm install

3. Run validation scripts

   # Check for duplicate tools
   npm run check-duplicates
   
   # Validate all links and data
   npm run validate

4. Open in your browser

   # Simply open index.html in your preferred browser
   # Or use a local development server:
   
   # Using Node.js (if installed):
   npx serve .
   
   # Using PHP (if installed):
   php -S localhost:8000
   
   # Or just double-click index.html to open in browser

5. Make your changes

   • Edit links.json to add/modify tools
   • Update contributors.json to add yourself
   • Modify CSS/JS as needed

🔧 Validation & Quality Assurance

This project includes automated validation to maintain high quality:

Automated Checks

# Check for duplicate tools across categories
npm run check-duplicates

# Validate all links and data structure
npm run validate

What Gets Validated

• Link Accessibility: All tool URLs are checked for availability
• Data Structure: JSON files are validated for proper format
• Duplicate Detection: Prevents adding tools that already exist
• Contributor Profiles: Ensures all contributor data is complete
• Category Consistency: Verifies proper categorization

📋 Contribution Guidelines

For AI Tools

• Free or Freemium: Tools should have a free tier or be completely free
• Working Links: Ensure all URLs are active and correct
• Accurate Descriptions: Provide clear, concise descriptions (max 60 characters)
• Appropriate Category: Place tools in the right category
• No Duplicates: Check if the tool already exists using validation scripts

For Code Contributions

• Clean Code: Follow existing code style and structure
• Test Changes: Ensure your changes don't break existing functionality
• Responsive Design: Maintain mobile-friendly design
• Performance: Keep the site fast and lightweight

Current Categories

• AI Writing & Content ✍️: Writing, editing, content creation tools
• AI Design & Images 🎨: Image generation, design, visual content tools
• AI Presentations 📊: Presentation creation and slide design tools
• AI Coding & Development 💻: Code assistance and development tools
• AI Video & Audio 🎬: Video editing, audio processing, multimedia tools
• AI Productivity ⚡: Productivity, automation, and research tools
• AI Entertainment 😂: Fun and entertainment AI tools
• AI Model Prototyping 🧪: AI model development and testing tools
• AI Game & Strategy 🎮: Gaming and strategic AI applications
• AI Local Models 🖥️: Tools for running AI models locally

Creating New Categories

If you want to add a new category:

1. Add to links.json:

   {
     "name": "New Category Name",
     "icon": "🔥", // Choose an appropriate emoji
     "links": [
       // Your tools here
     ]
   }

2. Ensure it fits the theme: Should be AI-related tools

🎨 Design Guidelines

• Consistent Styling: Follow the existing design patterns
• Accessibility: Ensure good contrast and keyboard navigation
• Mobile First: Design should work on mobile devices
• Performance: Optimize images and minimize code

📈 Analytics

This project uses Google Analytics to track:

• Page views and user engagement
• Popular tools and categories
• Geographic distribution of users
• Device and browser usage

Analytics help us understand how to improve the collection and what tools are most valuable to users.

🏆 Contributors

Thank you to all the amazing people who have contributed to this project!

📄 License

This project is open source and available under the MIT License.

🚀 Features & Roadmap

Current Features

• ✅ 100+ curated AI tools across 10 categories
• ✅ Real-time search and filtering
• ✅ Responsive design for all devices
• ✅ Progressive Web App (PWA) support
• ✅ SEO optimized with social media integration
• ✅ Community contributor system
• ✅ Automated link validation
• ✅ Duplicate detection system

Upcoming Features

• 🔄 Advanced filtering by pricing tiers
• 🔄 Tool rating and review system
• 🔄 API for developers
• 🔄 Mobile app versions
• 🔄 Multi-language support
• 🔄 Tool comparison features

🙏 Acknowledgments

• Original Creator: Arshdeep Singh
• All Contributors: Thank you to our 15+ contributors for making this project better!
• AI Tool Creators: Thanks to all the amazing AI tool developers
• Open Source Community: For the inspiration and support

📞 Contact & Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Creator: Arshdeep Singh
• Website: AI Tools Collection

---

⭐ If you find this project helpful, please give it a star on GitHub!

Made with ❤️ by the community