Vertigo is an innovative, self-hosted web app designed to help you effortlessly organize and track your physical comic book collection. Built using cutting-edge technologies like Vue.js and Flask, Vertigo is a modern solution for comic book enthusiasts looking to streamline their collection management.

Key Features of Vertigo

With Vertigo, you can:

  • Easily search and filter your comics by title, publisher, and more
  • Track your reading progress with features like read/unread, backlog, and ratings
  • Generate insightful statistics about your collection to help you make informed decisions
  • Export your user data to popular formats like spreadsheets for easy analysis
  • Explore options to integrate with external APIs for automatic fetching of details

Getting Started with Vertigo

Vertigo has entered its Alpha release stage, allowing you to experience the app's features firsthand. To get started, download the latest ZIP from the releases section and follow these steps:

  1. Extract the ZIP file
  2. Run the app using the appropriate script for your operating system:
  • Linux: runlaunch.sh
  • Windows: runlaunch.bat
  1. This will set up and launch the webapp in http://localhost:6166

Technical Requirements

To run Vertigo, you'll need:

  • Python 3 (https://www.python.org/downloads/)
  • Node.js and npm (https://nodejs.org/)

Setting Up Your Development Environment

If you're interested in contributing to or customizing Vertigo's codebase, follow these steps:

  1. Clone the repository: git clone https://github.com/anonhacker47/vertigo-comic-collection -b main
  2. Navigate to the project directory: cd vertigo-comic-collection
  3. Set up a Python 3 virtualenv and install dependencies:
  • cd vertigo-backend
  • python3 -m venv venv
  • source venv/bin/activate
  • pip install -r requirements.txt
  1. Create the database and run the Flask app:
  • alembic upgrade head
  • flask run

By default, you can access the app at http://localhost:5000/. If you want to work on the frontend, follow these additional steps:

  1. Install dependencies: cd vertigo-ui followed by npm install
  2. Run the Vue.js frontend: npm run dev
  3. Access the frontend at http://localhost:5173/

Join the Vertigo Community

If you have any ideas or suggestions for improving Vertigo, feel free to reach out!