anonhacker47 / Vertigo

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Logo

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

Vertigo Homepage Screenshot



⚠ 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:

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

About

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

License:MIT License


Languages

Language:Python 39.7%Language:CSS 28.9%Language:Vue 22.2%Language:JavaScript 8.3%Language:HTML 0.5%Language:Mako 0.4%Language:Shell 0.0%