IntelPedia Open Source - AI Tools Directory Platform

IntelPedia Open Source is a comprehensive AI tools directory platform built with Next.js 15 and TypeScript. This open-source version provides a complete foundation for building your own AI tools directory, featuring modern web technologies, robust admin dashboard, and integration with headless CMS.

🌟 Star this repo if you find it useful and want to support open-source development!

🚀 Features

🔍 AI Tools Directory

• Curated Collection: Organize AI tools across multiple categories
• Advanced Search & Filtering: Full-text search with tag and pricing filters
• Tool Submission System: Community-driven tool discovery
• Admin Dashboard: Complete CRUD operations for tool management
• Featured Tools System: Highlight important tools

💰 Smart Pricing System

• Free Tools: Completely free AI tools
• Freemium Models: Tools with free tiers and premium options
• Paid Solutions: Professional AI tools with transparent pricing
• Flexible Pricing Display: Customizable pricing models

🏗️ Admin Features

• Tool Management: Full CRUD operations
• Pending Submissions: Review and approve community contributions
• Bulk Operations: Efficiently manage large tool datasets
• Authentication System: Secure admin access

📝 Content Management

• Headless CMS Integration: Ready for Wisp CMS or alternatives
• SEO Optimized: Complete meta tags and structured data
• Dynamic Sitemaps: Auto-generated XML sitemaps
• Blog System Ready: Integrated blog infrastructure

🚀 Performance & SEO

• ISR (Incremental Static Regeneration): Optimal performance
• Server Components: Next.js 15 App Router with Server Components
• Advanced SEO: Schema.org markup, OpenGraph, Twitter cards
• Core Web Vitals Optimized: Google performance metrics ready

🎨 Modern UI/UX

• Responsive Design: Mobile-first approach
• Dark/Light Mode: System-aware theme switching
• Shadcn UI: Modern, accessible components
• Tailwind CSS: Utility-first styling

🛠️ Tech Stack

• Framework: Next.js 15 with App Router & Server Components
• Language: TypeScript for type safety
• Database: MongoDB with Mongoose ODM
• Styling: Tailwind CSS + Shadcn UI
• Authentication: JWT-based admin authentication
• Validation: Zod for runtime type validation
• Deployment: Vercel-ready configuration

🚀 Quick Start

Prerequisites

• Node.js 18.0 or later
• MongoDB instance (local or cloud)
• Git

Note: This project uses React 19. Some dependencies may require --legacy-peer-deps during installation until they fully support React 19.

Installation

1. Clone the repository

   git clone https://github.com/Gitnaseem745/intelpedia-os.git
   cd intelpedia-os

2. Install dependencies

   npm install --legacy-peer-deps
   # or
   yarn install

3. Environment Setup

   cp .env.example .env.local

   Edit .env.local with your configurations:

   # Required
   MONGODB_URI=mongodb://localhost:27017/intelpedia
   JWT_SECRET=your-jwt-secret-here
   ADMIN_PASSWORD=your-bcrypt-hashed-password
   
   # Optional (for production)
   NEXT_PUBLIC_BASE_URL=http://localhost:3000
   NEXT_PUBLIC_GA_ID=your-google-analytics-id

4. Run the development server

   npm run dev

5. Visit your application

   • Main site: http://localhost:3000
   • Admin dashboard: http://localhost:3000/admin
   • Tools directory: http://localhost:3000/tools

📁 Project Structure

src/
├── app/                     # Next.js App Router
│   ├── (pages)/            # Public pages
│   │   ├── tools/          # Tools directory & detail pages
│   │   ├── submit-tool/    # Tool submission form
│   │   └── blog/           # Blog pages (CMS integration)
│   ├── admin/              # Admin dashboard
│   │   └── tools/          # Tool management interface
│   ├── api/                # API endpoints
│   │   ├── tools/          # Tools CRUD operations
│   │   └── auth/           # Authentication endpoints
│   └── (sitemaps)/         # Dynamic sitemap generation
├── components/             # Reusable UI components
│   ├── ui/                 # Shadcn UI components
│   ├── admin/              # Admin-specific components
│   └── forms/              # Form components
├── lib/                    # Utility functions
│   ├── db.ts              # Database connection
│   ├── auth-utils.ts      # Authentication utilities
│   └── validation.ts      # Validation schemas
├── models/                 # MongoDB/Mongoose models
└── config/                 # Configuration files

🔧 Configuration

Database Setup

The platform supports MongoDB. Update your .env.local:

# Local MongoDB
MONGODB_URI=mongodb://localhost:27017/intelpedia

# MongoDB Atlas (cloud)
MONGODB_URI=mongodb+srv://username:[email protected]/database

Admin Authentication

1. Generate admin password hash:

   const bcrypt = require('bcryptjs');
   const hash = bcrypt.hashSync('your-password', 12);
   console.log(hash);

2. Add to environment:

   ADMIN_PASSWORD=your-bcrypt-hash-here
   JWT_SECRET=your-random-jwt-secret

CMS Integration

The platform is designed to work with headless CMS. For Wisp CMS integration:

NEXT_PUBLIC_BLOG_ID=your-wisp-blog-id

🚀 Deployment

Vercel (Recommended)

1. Connect your repository to Vercel
2. Add environment variables in Vercel dashboard
3. Deploy automatically on git push

Manual Deployment

npm run build
npm run start

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Add tests if applicable
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to the branch: git push origin feature/amazing-feature
7. Open a Pull Request

Code Style

• Use TypeScript for all new code
• Follow the existing code style
• Run npm run lint before committing
• Write meaningful commit messages

📝 API Documentation

Tools API

• GET /api/tools - Get all tools with filtering
• POST /api/tools - Create new tool (admin only)
• GET /api/tools/[id] - Get specific tool
• PUT /api/tools/[id] - Update tool (admin only)
• DELETE /api/tools/[id] - Delete tool (admin only)

Authentication API

• POST /api/auth/login - Admin login
• POST /api/auth/logout - Admin logout
• GET /api/auth/verify - Verify admin token

🐛 Bug Reports & Feature Requests

Please use GitHub Issues to report bugs or request features.

📄 License

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

🙏 Acknowledgments

• Next.js - The React framework for production
• Shadcn UI - Beautiful and accessible components
• Tailwind CSS - Utility-first CSS framework
• MongoDB - NoSQL database

📞 Support

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues

---

Built with ❤️ for the open-source community

⭐ Don't forget to star this repository if you found it helpful!