# TOOLS HUB - AI CONTEXT DOCUMENTATION
# Last Updated: February 6, 2026
# Purpose: User-facing features and capabilities context for AI agents

================================================================================
WEBSITE OVERVIEW
================================================================================

Name: Tools Hub
Live URL: https://hub.toolszone.net
Purpose: A curated platform to discover, compare, and explore online tools
Philosophy: "Clarity over marketing noise" - provides practical information without promotional content
Target Audience: Professionals and individuals seeking tools for work and productivity

================================================================================
WHAT USERS CAN DO ON THIS WEBSITE
================================================================================

1. DISCOVER TOOLS BY CATEGORY
   Users can browse tools organized into categories such as:
   - AI Tools (artificial intelligence and machine learning)
   - Development (code editors, IDEs, developer tools)
   - Design (UI/UX design, graphic creation)
   - Productivity (task management, organization)
   - Marketing (advertising, analytics, social media)
   - Writing (content creation, editing)
   - Video (editing, streaming, production)
   - Audio (editing, production, podcasting)
   - And more specialized categories

   Each category has its own dedicated page showing all tools in that category.

2. SEARCH FOR TOOLS
   Users can search for tools by:
   - Tool name (e.g., "ChatGPT", "Figma")
   - Keywords in tool descriptions
   - Search works across the entire tool database
   - Search results update in real-time as users type

3. FILTER TOOLS BY FEATURES
   Users can filter tools based on specific capabilities and attributes:
   
   AI & Generation Features:
   - AI Image Generation (creates images from text)
   - AI Video Generation (creates videos from scratch)
   - AI Text Generation (writes content)
   - AI Chat (conversational AI assistants)
   - AI Video Editing (edits existing videos)
   - AI Audio Editing (edits audio files)
   - AI Voice Generation (text-to-speech, voice cloning)
   - AI Short Clip Generation (creates highlights from long videos)
   
   Development Features:
   - Code Completion (AI-powered coding assistance)
   - API Testing (testing APIs and endpoints)
   - Version Control (managing code versions)
   
   Design Features:
   - UI/UX Design (interface and experience design)
   - Real-time Editing (collaborative live editing)
   - Collaboration (team features)
   
   Video Infrastructure Features:
   - Live Streaming Infrastructure (build streaming platforms)
   - VOD Infrastructure (video-on-demand platforms)
   - Video Transcoding (convert video formats)
   - CDN Delivery (content delivery networks)
   - Video Storage (cloud video hosting)
   - DRM Support (content protection)
   - Adaptive Bitrate Streaming (quality adjustment)
   
   General Features:
   - Open Source (freely available source code)
   - Free Version (free tier or plan available)
   - Free Credits (trial credits provided)
   - Periodic Credits (regular credit refreshes)
   - Collaboration (team/multi-user features)
   - Analytics (usage tracking and insights)
   - Automation (automated workflows)
   - Search (search functionality within tool)
   - Cloud Hosting (hosted infrastructure)

4. COMBINE SEARCH AND FILTERS
   Users can use search and filters together:
   - Search for a term AND filter by specific features
   - Example: Search "video" + filter by "Free Version" + filter by "AI Video Editing"
   - Filters narrow down search results
   - Multiple filters can be applied simultaneously

5. FILTER BY PRICING
   Users can see tool pricing information:
   - Free: Completely free tools with no paid tier
   - Freemium: Free version available with optional paid upgrades
   - Paid: Paid-only tools (may offer free trials/credits)
   - Pricing tier is displayed on each tool card for quick reference
   - Users can easily identify budget-friendly tools

6. SAVE FAVORITE TOOLS
   Users can create a personalized list of favorite tools:
   - Click the heart icon on any tool card to save it to favorites
   - Favorites are saved locally in the browser (no login required)
   - View all favorites on the dedicated Favorites page (/favorites)
   - Easily access tools you like to use or want to remember
   - Favorites list persists across browser sessions
   - Link in navbar: "♥ Favorites" shows your saved tools

7. COMPARE TOOLS SIDE-BY-SIDE
   Users can select tools and compare their features:
   - Click the checkbox on tool cards to select up to 4 tools
   - When 2+ tools are selected, a floating "Compare (n)" button appears
   - Comparison page shows all tools' features in a table format
   - Pricing tiers displayed for each tool being compared
   - Green checkmark (✓) for supported features, red X for unsupported
   - Features from all 25+ categories are shown for easy comparison
   - Users can remove tools from comparison and add more
   - Navigate to: /comparison (automatic when tools selected)

8. QUICK PREVIEW OF TOOLS
   Users can preview tools without leaving the site:
   - Click any tool card to open a preview modal
   - Modal shows full description, features, pricing, and categories
   - Green checkmarks indicate which features the tool has
   - "Visit Tool" button opens the tool's website in a new tab
   - Add tool to favorites from the preview
   - Navigate between tools using arrow buttons or arrow keys (← →)
   - Close with X button or ESC key
   - Favorite button in preview footer

9. SHARE FILTERED RESULTS
   - When users apply filters or search, the URL updates automatically
   - Users can copy and share the URL to share exact search results
   - "Share Results" button copies the current URL to clipboard
   - Anyone with the link sees the same filtered results

10. SMART EMPTY STATE HANDLING
    When no tools match user's search/filters:
    - Helpful message explaining why no results found
    - Popular search suggestions relevant to their query
    - Quick links to clear filters or start over
    - Browse by category button to explore other options
    - Instead of blank page, users get guidance to find what they need

11. PAGINATION FOR MOBILE & PERFORMANCE
    - Tools are displayed with pagination (24 per page)
    - "Previous" and "Next" buttons for navigation
    - Page numbers displayed with intelligent pagination controls
    - Mobile-friendly: Reduces scrolling on mobile devices
    - Improves performance by loading fewer tools at once
    - Current page is saved in URL for bookmarking
    - Works seamlessly with search and filter combinations

12. VIEW TOOL DETAILS
    Each tool listing shows:
    - Tool name
    - Brief description (what it does, key features)
    - Categories it belongs to
    - Pricing tier (Free/Freemium/Paid)
    - Feature badges (visual indicators of capabilities)
    - Affiliate link indicator (if applicable)
    - Direct link to the tool's website
   
   Users click the tool card to visit the tool's official website.

================================================================================
WEBSITE PAGES & NAVIGATION
================================================================================

MAIN PAGES:

1. Homepage (/)
   - Welcome message and site description
   - Large search bar prominently displayed
   - Quick access to browse all tools
   - Grid of featured categories
   - Call-to-action buttons to explore tools

2. All Tools Page (/tools)
   - Complete list of all tools in the database (with pagination)
   - Search bar at the top
   - Feature filter dropdown
   - Category selector dropdown
   - Results count and pagination controls
   - Grid layout of tool cards with pricing badges
   - Comparison checkboxes on each tool card
   - Floating "Compare (n)" button when tools selected

3. Favorites Page (/favorites)
   - Shows all tools saved to user's favorite list
   - Empty state with link to browse tools if no favorites
   - Same tool cards as other pages
   - Search and filter capabilities
   - Quick way to access your saved tools

4. Comparison Page (/comparison)
   - Compare selected tools side-by-side
   - Table format with all 25+ features
   - Tool name, pricing tier, and remove button in header columns
   - Green checkmarks (✓) for supported features
   - Red X for unsupported features
   - "Remove" button under each tool name
   - "Clear Comparison" button to reset selection
   - "Add More Tools" button to go back to tools page

5. Categories Page (/categories)
   - Overview of all available categories
   - Grid of category cards
   - Each card shows category name, icon, and description
   - Click any category to see tools in that category

6. Individual Category Pages (/categories/[category-name])
   - Shows all tools for a specific category
   - Examples: /categories/ai, /categories/development, /categories/design
   - Search bar and feature filters relevant to that category
   - Category name and description at the top
   - Grid of tools within that category
   - Pagination support for categories with many tools

7. About Page (/about)
   - Information about the platform
   - Purpose and mission
   - How to use the site

NAVIGATION:
- Header menu: Home, All Tools, Categories, ♥ Favorites, About
- Footer links: Navigation menu, Category shortcuts, Sitemap, robots.txt, AI context file
- Floating "Compare (n)" button visible when 2+ tools selected
- All pages accessible from any other page
- Search available on multiple pages

================================================================================
TOOL CATEGORIES AVAILABLE
================================================================================

The website organizes tools into these main categories:

1. AI Tools
   - Artificial intelligence platforms
   - Machine learning tools
   - AI assistants and chatbots
   - Generative AI tools

2. Development
   - Code editors and IDEs
   - Version control systems
   - API testing tools
   - Developer utilities
   - Programming languages and frameworks

3. Design
   - UI/UX design tools
   - Graphic design software
   - Prototyping tools
   - Design collaboration platforms

4. Productivity
   - Task management
   - Note-taking apps
   - Time tracking
   - Organization tools
   - Project management

5. Marketing
   - Social media management
   - Email marketing
   - SEO tools
   - Analytics platforms
   - Advertising tools

6. Writing
   - Content creation tools
   - Grammar and editing
   - Writing assistants
   - Blogging platforms

7. Video
   - Video editing software
   - Video hosting platforms
   - Streaming infrastructure
   - Video production tools

8. Audio
   - Audio editing software
   - Podcasting tools
   - Music production
   - Voice recording

9. Conversational AI
   - Chatbots
   - AI conversation platforms
   - Virtual assistants

10. Image Generation
    - AI image creators
    - Photo editing tools
    - Graphic generators

...and many more specialized categories

================================================================================
TOOL INFORMATION PROVIDED
================================================================================

For each tool, users can see:

1. Tool Name
   - Official name of the tool/platform

2. Description
   - Brief 1-2 sentence explanation of what the tool does
   - Focus on practical use cases
   - No marketing language, just facts

3. Categories
   - Which categories the tool belongs to
   - Tools can belong to multiple categories
   - Helps users understand the tool's primary purposes

4. Features/Capabilities
   - Visual badges showing what the tool can do
   - Examples: "AI Chat", "Free Version", "Open Source", "Collaboration"
   - Only shows features that are actually available in that tool

5. Link to Tool
   - Direct link to the tool's official website
   - Clicking the tool card takes users to the external site
   - Opens in current tab (users navigate to the actual tool)

6. Pricing Indicators
   - "Free Version" badge if tool has a free tier
   - "Free Credits" badge if tool offers trial credits
   - "Periodic Credits" if tool refreshes credits regularly

================================================================================
SEARCHING & FILTERING EXPLAINED
================================================================================

HOW SEARCH WORKS:
- Type keywords into the search bar
- Searches through tool names and descriptions
- Results update as you type
- Case-insensitive (works with any letter case)
- Example searches: "video editor", "chatbot", "design tool", "free AI"

HOW FILTERING WORKS:
- Click the "Features" filter dropdown
- Select one or multiple features you want
- Only tools with ALL selected features will show
- Example: Select "Free Version" + "AI Image Generation" = shows only free AI image tools

HOW CATEGORY FILTERING WORKS:
- On the "All Tools" page, use the category dropdown
- Select a category to see only tools in that category
- On individual category pages, filtering is automatic

COMBINING THEM:
- You can use search + feature filters + category at the same time
- Example: Category "AI" + Search "chat" + Filter "Free Version" = Free AI chat tools
- More filters = fewer, more specific results

SHARING RESULTS:
- When you apply filters, the page URL changes
- Copy the URL from your browser (or use "Share Results" button)
- Send the URL to someone else
- They'll see the exact same filtered results

CLEARING FILTERS:
- Remove search text to stop searching
- Uncheck features to remove those filters
- Select "All Categories" to see all categories again

================================================================================
COMMON USER QUESTIONS & ANSWERS
================================================================================

Q: How many tools are listed?
A: The website contains 700+ tools across all categories.

Q: Are all tools free?
A: No. The database includes free, freemium, and paid tools. Each tool displays its pricing tier (Free/Freemium/Paid).

Q: Can I submit a tool?
A: Currently, tool submissions are managed by the site administrators. Check the About page for contact information.

Q: Do you get paid for recommending tools?
A: Some tool links may include referral codes where available, but this doesn't affect which tools are listed or how they're described.

Q: How are tools organized?
A: Tools are organized by categories (AI, Development, Design, etc.) and can be filtered by features (Free, Open Source, specific capabilities).

Q: Can I compare tools side-by-side?
A: Yes! Select 2-4 tools using checkboxes on tool cards, then click the floating "Compare (n)" button to see a side-by-side feature comparison table.

Q: Can I save my favorite tools?
A: Yes! Click the heart icon on any tool card to save it to your Favorites list. Access your favorites via the "♥ Favorites" link in the navigation.
   Favorites are saved in your browser (no login required).

Q: How do I preview a tool before visiting it?
A: Click on any tool card to open a preview modal. You can see the full description, features, pricing, and more without leaving the site.

Q: Are tool descriptions accurate?
A: Descriptions focus on factual information about what each tool does. They're kept brief and practical, without marketing hype.

Q: How often is the database updated?
A: Tools are regularly reviewed and updated. New tools are added as they become relevant.

Q: What does "Featured Category" mean?
A: Featured categories are displayed prominently on the homepage and categories page for easy access to popular tool types.

Q: How does pricing information help me?
A: Pricing tiers (Free, Freemium, Paid) are displayed on every tool card. Freemium tools offer free versions with optional paid upgrades.
   Free tools are completely free. Paid tools may offer free trials or credits.

Q: Can I share my search results?
A: Yes! When you apply filters or search, the URL updates automatically. Share the URL with others and they'll see the exact same results.

Q: How do I navigate on mobile?
A: Tools Hub is fully responsive. Pagination helps mobile users by showing 24 tools per page instead of requiring extensive scrolling.
   All features work on mobile, including comparisons, favorites, and search/filters.

================================================================================
WEBSITE FEATURES SUMMARY
================================================================================

✓ Browse 700+ tools across 20+ categories
✓ Search by name or keywords
✓ Filter by 25+ features and capabilities
✓ View pricing tier (Free, Freemium, Paid) for each tool
✓ Combine search, filters, and categories
✓ Share filtered results via URL
✓ Save favorite tools with heart icon
✓ Access favorites list from dedicated page (/favorites)
✓ Compare 2-4 tools side-by-side with feature table
✓ Quick preview modal for each tool
✓ Navigate between tools in preview with arrow keys
✓ View clear, practical tool descriptions
✓ Access direct links to all tools
✓ Find free tools easily with pricing badges
✓ Discover open-source alternatives
✓ Mobile-friendly responsive design with pagination
✓ Fast, clean interface without clutter
✓ No registration required to browse, save favorites, or compare
✓ Smart empty state messages with helpful suggestions

================================================================================
IMPORTANT NOTES
================================================================================

- This is a DIRECTORY/DISCOVERY platform, not a tool comparison or review site
- No user ratings or reviews are displayed
- No detailed tool comparisons are available
- All tools link to their official external websites
- The site doesn't host any of the tools themselves
- Focus is on helping users find tools, not reviewing them in depth
- Information is curated by the site team, not user-generated

================================================================================
ACCESSIBILITY & USAGE NOTES
================================================================================

- Website works on desktop computers, tablets, and mobile phones
- Dark theme by default (easier on eyes, reduces eye strain)
- Keyboard navigation supported for accessibility
- Tool links open in the same browser tab (standard navigation)
- Footer links to sitemap, robots.txt, and AI context open in new tabs
- No account or login required to browse and search
- Fast loading times and clean interface

================================================================================
CURRENT STATISTICS (as of January 30, 2026)
================================================================================

Total Tools: 700+
Total Categories: 20+
Total Features: 25+
Pages: 5 main pages + individual category pages (dynamic)

================================================================================
END OF DOCUMENTATION
================================================================================

This file serves as context for AI agents to understand what users can do on
Tools Hub and how to help them navigate and use the website effectively.