StoryMaker

An aesthetic organizer for different types of entities in books and book worlds for writers.

Backend (FastAPI + SQLAlchemy + Alembic + Postgres)

• Code: backend/app
• Key pieces:
  • main.py – FastAPI app and CORS
  • core/config.py – settings and DATABASE_URL
  • db/session.py – engine, SessionLocal, Base, get_db
  • models/entities.py – World, Book, Character, Location
  • schemas/entities.py – Pydantic schemas
  • api/entities.py – CRUD-style endpoints for listing/creating entities
  • Alembic config in backend/alembic.ini, backend/migrations

Install & run backend

cd backend
python -m venv .venv
.venv\Scripts\activate          # on Windows
pip install -r requirements.txt

# make sure Postgres is running and DATABASE_URL in app/core/config.py is correct
alembic upgrade head

uvicorn app.main:app --reload --port 8000

Frontend (Vite + Vue 3)

• Code: frontend
• Vite-based Vue 3 SPA with an aesthetic dashboard layout.
• App.vue currently uses sample in-memory data for worlds, books, characters, and locations.
• Next step is to wire it to the backend API (/api/entities/*) with Axios or fetch.

Install & run frontend

cd frontend
npm install      # already run once, but safe to repeat
npm run dev      # Vite dev server at http://localhost:5173

Next steps / ideas

• Hook Vue views up to the FastAPI endpoints (worlds, books, characters, locations).
• Add create/edit forms with live aesthetic previews (colors, tags, vibes).
• Add per-project workspaces so each book/world has its own board.
• Add authentication if you want multi-user access.