anonhacker47 / vertigo

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

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 is not released yet, and is under active development, but if you can try it out using the Developer Guide below.

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