Skip to content

ManjunathDharappanavar/anime-list

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Anime Discovery Platform

Anime List Logo

A curated anime discovery platform featuring popular series with direct access to streaming resources and comprehensive information

Features β€’ Demo β€’ Installation β€’ Usage β€’ Contributing

License Stars Forks Issues


πŸ“‹ Table of Contents

Click to expand

πŸš€ About

This anime discovery platform provides a streamlined interface for exploring popular anime series through a carefully curated collection. The application focuses on delivering essential information about acclaimed anime titles while providing direct access to streaming resources through established community channels.

The platform emphasizes user experience through clean visual design, intuitive navigation, and responsive functionality that works seamlessly across different devices. The application integrates external resources including Wikipedia for detailed series information and community channels for streaming access, creating a comprehensive resource for anime enthusiasts.

Project Objectives

The application addresses the need for a centralized anime discovery platform that combines series information with accessible streaming resources. The platform curates high-quality anime titles including legendary series such as Naruto, Bleach, One Piece, and Hunter X Hunter, providing users with essential information and direct access to viewing resources through established community channels.


✨ Features

Core Discovery Features

  • Curated Collection: Hand-selected popular anime series
  • Visual Catalog: High-quality poster images for each series
  • Instant Search: Real-time filtering by anime title
  • External Integration: Direct links to Wikipedia information
  • Community Access: Telegram channel integration for streaming

User Experience Features

  • Responsive Design: Optimized viewing across all devices
  • Interactive Cards: Hover effects with smooth transitions
  • Safety Warnings: User confirmation for external links
  • Background Imagery: Immersive anime-themed interface
  • Clean Navigation: Intuitive menu structure and search functionality

πŸ–₯️ Demo

Application Interface

Main Interface

Main interface showcasing anime collection with search functionality

Anime Cards

Responsive card layout featuring anime posters and access links

Live Application

Project Link: https://manjunathdharappanavar.github.io/anime-list


πŸ› οΈ Technologies Used

HTML5 CSS3 JavaScript Wikipedia API

Technical Architecture

The application utilizes vanilla JavaScript for dynamic content rendering and user interaction management. CSS3 provides responsive design implementation with advanced visual effects including background imagery, card animations, and hover transitions. HTML5 semantic structure ensures accessibility compliance and proper document organization for optimal user experience across different platforms and devices.

External Integrations

The platform integrates Wikipedia links for comprehensive anime information and community Telegram channels for streaming access. All external links include user confirmation dialogs to ensure transparency and user control over navigation to third-party resources.


πŸ“¦ Installation

System Requirements

The application operates as a client-side web application requiring only a modern web browser with JavaScript support. No server-side dependencies or database connections are necessary for basic functionality.

Component Requirement Purpose
Web Browser Modern JavaScript support Application runtime
Internet Connection Required External resource access
Local Server Recommended for development File protocol limitations

Quick Deployment

# Clone the repository
git clone https://github.com/ManjunathDharappanavar/anime-list.git

# Navigate to project directory
cd anime-list

# Option 1: Direct browser access
open index.html

# Option 2: Local development server (recommended)
# Using Python 3
python -m http.server 8000

# Using Node.js live-server
npx live-server

# Access application at http://localhost:8000

Production Deployment

GitHub Pages Deployment Guide
# Ensure repository visibility is set to public
# Navigate to repository Settings > Pages
# Configure source branch as main/master
# Application will be available at:
# https://manjunathdharappanavar.github.io/anime-list

πŸš€ Usage

Platform Navigation

The application provides a single-page interface with intuitive navigation elements. Users access the main anime collection through the central display area, utilize the search functionality through the prominent search bar, and navigate to external resources through clearly labeled action buttons on each anime card.

Search Functionality

The search system enables real-time filtering of the anime collection based on title matching. Users can enter partial or complete anime titles in the search input field, and the system will dynamically filter the displayed results to match the search criteria, providing immediate visual feedback without page refreshes.

External Resource Access

Each anime card provides two primary external access points. The "more info" link directs users to comprehensive Wikipedia articles containing detailed series information, character descriptions, and production details. The "Telegram link" provides access to community streaming channels, with user confirmation dialogs ensuring transparent navigation to external platforms.

Content Discovery

The platform organizes anime content through visual cards displaying high-quality poster images, series titles, and access buttons. The responsive grid layout adapts to different screen sizes while maintaining visual hierarchy and user accessibility across desktop and mobile devices.


πŸ“ File Structure

anime-list/
β”œβ”€β”€ index.html          # Main application interface
β”œβ”€β”€ script.js           # Core JavaScript functionality
β”œβ”€β”€ style.css           # Application styling and themes
β”œβ”€β”€ AL_img/            # Image assets directory
β”‚   β”œβ”€β”€ favicon.jpg     # Browser tab icon
β”‚   └── background.jpg  # Application background image
└── README.md          # Project documentation

Component Responsibilities

The index.html file provides semantic structure with navigation elements, search interface, and content display areas. The script.js file manages anime data storage, dynamic content rendering, search functionality, and external link handling with safety confirmations. The style.css file implements responsive design, visual themes, animation effects, and cross-device compatibility styling.


πŸ”§ API Reference

Core Functions

Content Rendering

renderAnimes(animes, containerID)

Description: Dynamically renders anime collection in specified DOM container

Parameters:

  • animes (Array): Collection of anime objects with id, name, image, info, and telegram_channel properties
  • containerID (String): Target DOM element identifier for content insertion

Implementation:

renderAnimes(animes, "animeList");

Functionality: Creates individual anime cards with poster images, title displays, and external access links while maintaining responsive grid layout structure.

Search Operations

searchAnime(query)

Description: Filters anime collection based on title search criteria

Parameters:

  • query (String): Search term for title matching (case-insensitive)

Returns: Filtered collection rendered in main display area

Usage Example:

searchAnime("Naruto"); // Displays Naruto-related results

Safety Management

confirmRedirect(link)

Description: Provides user confirmation for external link navigation

Parameters:

  • link (String): Target URL for external navigation

Security Features: Displays warning dialog and opens links in new browser tabs to maintain application session integrity.

Data Structure

const animes = [
    {
        id: 1,
        name: "Naruto",
        image: "poster-url",
        info: "wikipedia-link",
        telegram_channel: "community-channel-link"
    }
    // Additional anime entries...
];

πŸ“‹ Content Guidelines

Anime Selection Criteria

The platform curates anime content based on popularity metrics, critical acclaim, cultural impact, and community engagement levels. Selected series represent diverse genres and storytelling approaches while maintaining broad appeal for anime enthusiasts at different experience levels.

Content Sourcing Standards

All anime poster images are sourced from reputable image hosting services with appropriate usage rights. Wikipedia links provide authoritative information sources with comprehensive series details. Community channels are selected based on active user engagement and content quality standards.

Quality Assurance

Regular content audits ensure link functionality, image availability, and information accuracy. External resource accessibility is monitored to maintain user experience quality and prevent broken link situations that could impact platform reliability.


🌐 Browser Compatibility

Browser Version Support Status
Chrome 70+ βœ… Full Support
Firefox 65+ βœ… Full Support
Safari 13+ βœ… Full Support
Edge 80+ βœ… Full Support
Mobile Browsers Modern βœ… Responsive Design

Technical Requirements

The application requires JavaScript ES6+ support for arrow functions and template literals. CSS Grid and Flexbox capabilities are essential for responsive layout functionality. Modern browser security policies are necessary for external link handling and cross-origin resource access.


🀝 Contributing

Development Participation

Contributors can enhance the platform through anime content expansion, user interface improvements, search functionality enhancements, and accessibility feature development. All contributions should maintain the established code quality standards and user experience consistency.

Content Contribution Process

  1. Research popular anime series with verifiable information sources
  2. Validate external links for Wikipedia articles and community channels
  3. Test search functionality and responsive design compatibility
  4. Document any new features or content additions thoroughly
  5. Submit pull requests with detailed change descriptions

Code Quality Standards

Maintain consistent JavaScript formatting with proper error handling for external resource access. Follow established CSS naming conventions and responsive design principles. Ensure HTML semantic structure compliance and accessibility standard adherence for inclusive user experience.


βš–οΈ Legal Notice

Content Disclaimer

This platform serves as an educational resource for anime discovery and does not host, stream, or distribute copyrighted content directly. All external links direct users to third-party platforms responsible for their own content licensing and distribution policies.

Intellectual Property

Anime titles, characters, and associated imagery remain the intellectual property of their respective creators, production companies, and distributors. This platform provides informational access to publicly available resources without claiming ownership of any copyrighted materials.

External Link Policy

The platform includes links to external websites and services beyond our control or ownership. Users navigate to external resources at their own discretion, and we do not guarantee the availability, accuracy, or appropriateness of external content.


πŸ“ž Contact

Platform Developer: Manjunath Dharappanavar

Email GitHub LinkedIn

Repository: https://github.com/ManjunathDharappanavar/anime-list


πŸ™ Acknowledgments

Recognition to the anime community, content creators, and open-source development resources that have contributed to this platform's development and ongoing improvement.

Content Sources: Wikipedia Foundation for comprehensive anime information resources and community channels for streaming access coordination.

Technical Resources: MDN Web Documentation for web development standards and best practices implementation guidance.

Community Support: Anime enthusiast communities providing feedback and suggestions for platform enhancement and content curation.


⭐ Support This Project

Show your appreciation for anime discovery resources by starring this repository.

Star Repository


Developed with passion for anime culture using modern web technologies

About

A webpage to find animes to watch, provides with wiki links to know more about animes

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors