Movie Zone

Movie Zone is a professional, modular, and secure movie search and discovery app built with React and Tailwind CSS. It demonstrates enterprise-grade architecture, security, and code quality for open-source and production use.

---

Problem Statement

Enable users to search, discover, and track trending movies with a modern, scalable, and secure web application.

Architecture & Tech Stack

• Frontend: React (Vite), Tailwind CSS
• Backend: Appwrite (with Supabase for analytics)
• API: TMDB (The Movie Database)
• Testing: Jest, React Testing Library
• Linting/Formatting: ESLint, Prettier

See docs/ARCHITECTURE.md for details.

Features

• Movie search via TMDB API
• Trending movies tracked in Supabase
• Responsive, accessible UI
• Secure by default (no secrets in code)
• Modular, maintainable codebase

Repository Structure

src/        # Core logic, React components, services, utils
config/     # Environment and configuration files
tests/      # Unit and integration tests
docs/       # Architecture, design, and contribution docs
scripts/    # Automation and developer utilities
public/     # Static assets

Getting Started

1. Clone the repository
2. Install dependencies: npm install
3. Copy .env.example to .env and fill in your API keys
4. Run the app: npm run dev

Security & Best Practices

• No hardcoded secrets (see .env.example)
• Input validation and error handling throughout
• SECURITY.md for policy and reporting

Testing

• Tests in tests/ (see example)
• Recommended: Jest, React Testing Library
• Run tests: npm test

Contributing

• See docs/CONTRIBUTING.md

Changelog

• See docs/CHANGELOG.md

Value

• Recruiter- and reviewer-friendly
• Secure, scalable, and easy to extend
• Clear architecture and documentation

---

For architecture, contribution, and security details, see the docs/ folder.