Vertigo

Vertigo is a web app designed to help you organize, manage, and track your comic book collection with ease. Created using Vue.js and Flask

⚠ Disclaimer ⚠: Vertigo is WIP and under active development. Expect occasional bugs, incomplete features, and potential breaking changes as I add new features and improve functionality. Only the basic CRUD is done till now.

Goals:

• A responsive modern web app to track and curate physical comicbook collection
• Search and filter options based on various criteria such as title, publisher etc.
• Track reading progress (read/unread, backlog and ratings if needed).
• Generate insightful statistics on collection.
• Explore options to integrate with external APIs for automatic fetching of details.
• Backup/Export User Data to commonly used formats.

Feel free to reach out if you have anything else you'd like to see!

Getting Started:

Vertigo has now entered its Alpha release stage! You can try it out by downloading the latest ZIP from the releases section.

After extracting the ZIP, run the app using the appropriate script for your operating system:

• Linux/macOS:
  Run launch.sh

• Windows:
  Run launch.bat

This will automatically set up and launch the webapp in http://localhost:6166

Note: If the app seems slow on the first launch, simply close and rerun the script — this is a known behavior during initial setup and should resolve on relaunch.

Developer Guide:

Prerequisites:

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

Clone the repository

git clone https://github.com/anonhacker47/vertigo-comic-collection -b main
cd vertigo-comic-collection

Setup

Set up a Python 3 virtualenv and install the dependencies on it:

cd vertigo-backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Create the db and run flask app:

alembic upgrade head
flask run

By default, You can try out the app from http://localhost:5000/ .

If you want to tinker with the Frontend follow the below instructions.

Frontend Setup

Install the dependencies:

cd vertigo-ui
npm install

Run the Vue.js frontend:

npm run dev

Voila! you can find the frontend at http://localhost:5173/

Acknowledgements

• Miguel Grinberg Microblog API