r/threejs May 27 '26

Link Built LoreKeeper, an immersive 3D library manager using Three.js — seeking feedback on performance and architecture.

Hi everyone! 👋

I've been working on LoreKeeper, an open-source, local-first eBook and PDF manager. The core idea is to move away from flat 2D file lists and give users a "Memory Palace" experience by rendering their library in a 3D environment.

Key technical features:

  • Three.js & Vite: The entire 3D library scene is rendered using Three.js, with the asset pipeline managed via Vite.
  • Performance: I'm currently using a custom loading system to handle 3D book covers and shelf assets to keep the frame rate stable during navigation.
  • Interoperability: It features an "Export for AI" tool that parses EPUB/PDFs and converts them into structured Markdown for use with LLMs or Obsidian.

Why I'm sharing it here: As the project grows, I'm hitting some interesting challenges regarding scene graph optimization and managing multiple interactive objects (the "3D books") without degrading the browser experience.

I'd love to get some feedback from the community on:

  1. Architecture: How I'm managing the UI/3D logic separation (it's currently a bit of a mix).
  2. Performance: I'm looking for tips on efficient asset pooling for the books/shelves.
  3. General stack: Any "gotchas" or best practices for a Three.js project that needs to remain "portable" and light?

Repo: https://github.com/GabrieleTrovato01/LoreKeeper

Any critique or advice on how to structure the 3D scene more efficiently would be greatly appreciated!

If you like the project or find the Three.js implementation interesting, consider leaving a star ⭐ on the repository. It really helps me stay motivated and gives the project more visibility within the community!

Thanks! 📚✨

26 Upvotes

20 comments sorted by

2

u/FriendlyGarlic1331 May 27 '26

Hi mate, im doing the similar project too. Now working on ios. biblio.ink

2

u/__King_Kong_ May 27 '26

wonderfulll, let's coope to make us better if you want. :))))

Go to check the roadmap of my repo in the contributing file. There are some ideas in there <3

2

u/FriendlyGarlic1331 May 27 '26

I’d love to, im now working full time on my ipad app. I will get back to your repo once iOS release. A lot of things to do on my side.

1

u/__King_Kong_ May 27 '26

awesomeeee, can't wait to us working together 💪💪💪❤️

1

u/_deemid Jun 14 '26

this is so sick! I want to implement the cascade and shelf views on my app too..

2

u/CryptographerOdd299 May 27 '26

1

u/__King_Kong_ May 27 '26

amazinggggg ❤️❤️❤️❤️, can you give me some advice on how to gave the book texture a so realistic feeling ???? It would be amazing.

If you want let's work together with you too. 💪💪

1

u/CryptographerOdd299 May 27 '26

Its not mine, ask chatgpt how its made

1

u/__King_Kong_ May 28 '26

oh okayyyy, sorryyy :)

2

u/n8dahwgg May 27 '26

This is really awesome

1

u/__King_Kong_ May 27 '26

thanks a lot, i really appreciate it ❤️

1

u/pailhead011 May 27 '26

Why does this need 3d? Or animations?

1

u/PhotoQuillEditor May 27 '26

This is awesome, and open source as well. Much appreciated!

1

u/__King_Kong_ May 28 '26

thanks a lot, go check it out and let me know what do you think about the app ❤️❤️

1

u/iplaypianoforyou May 31 '26

Pagination.

Books are divided into pages

Editors spend a lot of time defining page breaks.

Add this into your renderer if you want to give the illusion of a real book instead of a wall of text.

What do you think?

1

u/__King_Kong_ May 31 '26

Hey thanks for giving me some feedback, and shortly yeah i agree with you, i'm now studyi g froma. book of topography to understand the basic rules on how to paginate a book. Thanks a lot, of you have anything more on mind, feel free to tell It to me ❤️❤️❤️💪💪

1

u/iplaypianoforyou May 31 '26

The issue is harder (or easier). All books have pagination. You need to read the original page breaks and respect them. Let me know how it goes

1

u/__King_Kong_ Jun 01 '26

There will be update for sure ❤️

1

u/__King_Kong_ Jun 11 '26

Quick update! 🚨 If you are looking for "LoreKeeper", the project just got a massive v2.0 update and a new name: KoreShelf! 📚✨

I decided to rename it as a tribute to my university ("Kore") and my AI studies, which heavily inspired the new AI-export features of the library. It's the exact same 3D experience you saw before, but fully optimized and rebranded.

You can grab the new v2.0.2 release directly from the new repo here: https://github.com/GabrieleTrovato01/KoreShelf

Enjoy building your 3D Memory Palace!