Skip to content

securecloudx/vuln-weather-app

Repository files navigation

vuln-weather-app

A simple vulnerable by design weather application built for the SecureCloudX Hackathon. To teach participants security from code to cloud for cloud native applications.

About the App

  • Fetches current weather data for any city
  • Simple and intuitive user interface
  • Built with React and Vite
  • Deliberately vulnerable for educational purposes

Vulnerable Weather App

Getting Started (Technical Details)

Local Development

  1. Clone the repository:

    git clone https://github.com/your-username/vuln-weather-app.git
    cd vuln-weather-app
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev

Docker

This application can be run using Docker for easy deployment and development.

Prerequisites

  • Docker installed on your system
  • Docker Compose (optional, for easier management)

Quick Start with Docker

  1. Build the Docker image:

    docker build -t vuln-weather-app .
  2. Run the container:

    docker run -d -p 5173:5173 vuln-weather-app

    The app will be available at http://localhost:5173

Docker Compose (Recommended)

If you prefer using Docker Compose, create a docker-compose.yml file:

version: "3.8"
services:
  weather-app:
    build: .
    ports:
      - "5173:5173"
    environment:
      - NODE_ENV=development
    volumes:
      - .:/app
      - /app/node_modules

Then run:

docker compose up

Development with Docker

For development with hot reload, you can mount the source code as a volume:

docker run -p 5173:5173 -v $(pwd):/app -v /app/node_modules vuln-weather-app

Useful Docker Commands

  • Stop running container: docker stop <container-id>
  • View running containers: docker ps
  • View container logs: docker logs <container-id>
  • Remove container: docker rm <container-id>
  • Remove image: docker rmi vuln-weather-app
  • Clean up unused containers/images: docker system prune

Docker Compose Commands

  • Start services: docker-compose up
  • Start in background: docker-compose up -d
  • Stop services: docker-compose down
  • View logs: docker-compose logs -f
  • Rebuild and start: docker-compose up --build

License

This project is licensed for hackathon use only.

About

vuln-weather-app_securecloudX Hackathon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published