Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Alfredredbird/Open-Wrecks

🌊 Open-Wrecks

Open-Wrecks is a free and open-source, self-hosted shipwreck documentor & tracker.
It lets you record, manage, and visualize shipwrecks on an interactive map ~ with full account management and approval workflows.

β€œEvery wreck tells a story ~ Open-Wrecks helps preserve it.”

Frontend Backend License


⚑ Features

  • πŸ” Account System – Sign up, log in, and manage submissions.
  • πŸ—ΊοΈ Interactive Map – Explore shipwreck locations visually with markers.
  • πŸ“ Point Measurement System – To measure the distance between ships/points.
  • πŸ“ Submission Flow – Users submit shipwreck data β†’ admins approve β†’ it shows on the map.
  • βš›οΈ Modern Stack – Built with React frontend + Flask (Python) backend.
  • πŸ—Ύ Updated Info – Comes with 7 Map styles, 9 ship recycling yards and 81 ships (updated daily).
  • πŸ’Ύ Self-Hosted – All data is stored locally, under your control.
  • πŸ” View On Google Maps – All ships have the option to view the location on Google Maps.
  • πŸ› οΈ Constant Updates – I plan to update this project as much as possible.

πŸš€ Getting Started

1. Clone the Repository

git clone https://github.com/alfredredbird/Open-Wrecks.git
cd Open-Wrecks

2. Backend (Flask API)

cd open-wrecks-api
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 main.py

Runs on: http://127.0.0.1:5000 or local IP

3. Frontend (React UI)

cd open-wrecks
npm install
npm start

Runs on: http://127.0.0.1:3000 or local IP

4. Logging In

Default admin login credentials User: explorer Password: DeepSea

πŸ“‚ Project Structure

For those who are wondering!

Open-Wrecks/
│── open-wrecks-api/        # Flask API & account system
β”‚   β”œβ”€β”€ main.py
β”‚   └── data/       # Stores pending + approved submissions
β”‚
│── open-wrecks/       # React web app with map + UI
β”‚   β”œβ”€β”€ src/        # code
β”‚   └── public/     # stuff the "web" can see
β”‚
└── README.md

🀝 Contributing

Contributions are welcome!

  1. Fork the project

  2. Create a new branch (feature/my-new-feature)

  3. Commit your changes (git commit -m "Added a cool feature")

  4. Push to your branch (git push origin feature/my-new-feature)

  5. Open a Pull Request

πŸ“· Images

image

πŸ“œ License

Open-Wrecks is licensed under the MIT License. You’re free to use, modify, and distribute it β€” just give credit.

🌐 Links

πŸ“½οΈ Youtube Demo: https://youtu.be/Nf2mrm8cocI

πŸ“– Docs: (Coming soon)

πŸ“˜ Contact

πŸ›  Other Tools

Other tools in the fleet:

About

An Free And Open-Source ShipWreck Tracker And Viewer

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published