Files
Art-gallery/README.md
T
Danila KhodjaefandCursor 792a0b1a77 Improve 3D gallery UX, placeholders, and image accuracy.
Add multi-row dynamic halls, eye-level camera, canvas covers for missing works, preserved view when returning from detail, and corrected image overrides for Kauffman and Raphael. Update documentation and add fetched painting assets.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-19 11:40:08 +03:00

1.4 KiB

Art Gallery

Interactive virtual art gallery: zoomable historical timeline, art movement bands, one 3D hall per artist (dynamic wall layout, canvas placeholders for missing works, influence-linked exits), and painting detail views with preserved gallery camera on return.

Documentation

Document Purpose
Documentation/basics.md Architecture, layout, user flow
Documentation/setup.md Install, env, npm scripts
Documentation/DB_structure.md PostgreSQL tables
Documentation/API.md REST endpoints
Documentation/data-and-images.md Seeding and image pipeline

Stack

  • Backend: Node.js, Express, PostgreSQL
  • Frontend: React, Vite, Three.js (@react-three/fiber, @react-three/drei)

Setup

  1. Copy .env.example to .env and set database credentials.

  2. Install dependencies:

    npm install
    cd client && npm install && cd ..
    
  3. Apply database schema (requires PostgreSQL superuser for first-time setup):

    npm run migrate
    npm run seed
    
  4. Start the server:

    npm run server
    

    Open http://localhost:3001

Development

Run API and Vite dev server separately:

npm run dev:server   # http://localhost:3001
npm run dev:client   # http://localhost:5173 (proxies /api and /images)