Marvel Characters App

A web application that displays information about Marvel characters using React and Flask.

Features

• Browse Marvel characters
• Search functionality
• Responsive design
• Character details view

Prerequisites

• Node.js (v14 or higher)
• Python (v3.8 or higher)
• npm or yarn

Installation

Frontend Setup

# Install frontend dependencies
npm install

# Start the development server
npm start

Backend Setup

# Create and activate virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install Python dependencies
pip install -r requirements.txt

# Start the Flask server
python src/app.py

Project Structure

.
├── src/              # Source code files
│   ├── components/   # React components
│   ├── services/     # API services
│   └── styles/       # CSS styles
├── tests/            # Test files
├── docs/            # Documentation
├── data/            # Data files
└── scripts/         # Utility scripts

Environment Variables

Create a .env file in the root directory:

REACT_APP_API_URL=http://localhost:5000
MARVEL_API_KEY=your_api_key_here

Testing

# Run frontend tests
npm test

# Run backend tests
pytest

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

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

Acknowledgments

• Marvel API for providing character data
• React team for the amazing framework
• Flask team for the backend framework