How do you do further customization of the user interface?

How do you do further customization of the user interface, beyond what’s currently described in the documentation? For example, if I want to change the page title and the banner, which currently say “Gramps Web”, to e.g. “[My Family Name] Family Tree”, how would I achieve that? It looks as if Lit components are used for everything in the UI, but can some of those components be configured? Also, how would you make the page title configurable, as that’s seemingly not in a Lit component?

My version info:

Gramps 6.0.6
Gramps Web API 3.6.0
Gramps Web Frontend 25.12.0
Gramps QL 0.4.0
Sifts 1.1.1
locale: en
multi-tree: false
task queue: true
OCR: true
chat: false

See 🩹 Fixing static app-title by letsjustfixit · Pull Request #527 · gramps-project/gramps-web · GitHub and discussion therein.

Thanks. Questions arising from looking at that PR:

  • What is meant by the “database name”?
  • Is there a way of changing the database name through the Web UI? I couldn’t see it when logged in as an owner, under Administration. Not sure if it’s possible and I’ve just missed it.
  • Is there a reason to tie the app bar title display to the database name? There might be a desire for the app bar title to be something other than that, whether in multi-tree or single-tree setups.
  • The solution in the PR addresses the app bar, but not the page title as displayed through the <title> element. Is there any intrinsic objection to making this configurable?

I’m very new to Gramps Web and quite new to Gramps, so apologies if I’m asking what might be obvious to others.

Your second question is answered by the issue discussion.

We’ll change the app bar content from “Gramps Web” to the tree name (aka database name) once this is possible.

I am skeptical about changing the <title> element. Possibly we could use “Tree Name - Gramps Web”.

I think I see. Where does the name.txt file get set up? I couldn’t see any reference to it in the Dockerfile/repository.

This file is created by Gramps core when creating a new Gramps database.

1 Like