Deep Research on a laptop

Run this branch (deep-research) of the DX Life site on your own machine and look at the hidden Deep Research page and the Research page. No database, no Docker, no secrets.

You need

bun 1.3+ and node 20+
Your login for git.nuxtbase.app (the repo is private)

Steps

git clone -b deep-research --single-branch https://git.nuxtbase.app/doxa-life/doxa-maps-cdn.git dx-life-deep-research
cd dx-life-deep-research
bun install
PORT=4611 bun run dev

The first start compiles for about a minute; a page may answer 503 until it is done. Without a database the server only logs "skipping migrations" and the oauth sweeps' "DATABASE_URL is not set"; the map pages do not use a database.

No settings are needed. The maps use MapLibre, which needs no key, and read their data from DX Life's prayer API (https://pray.doxa.life, the default).

Open

Page	Address
Deep Research (hidden: in no menu, not indexed)	http://localhost:4611/deep-research
Deep Research in Arabic (right-to-left)	http://localhost:4611/ar/deep-research
One view of it, e.g. the Regions dashboard	http://localhost:4611/deep-research?tab=regions-dashboard
Research (as on doxa.life today, with our research map and, under it, the link to Deep Research)	http://localhost:4611/research
Regions (DX Life's own index, back in the menu)	http://localhost:4611/regions
Home, Pray, Adopt (DX Life's own maps, unchanged)	http://localhost:4611/, /pray, /adopt
Plugin Studio (it is in the maps folder; no page needed)	http://localhost:4611/dx-maps/plugin-studio/plugin-studio/

Map engine: MapLibre by default, Mapbox by one setting

Every map on the site uses MapLibre by default, including DX Life's own maps on the home, pray, adopt and country pages. MapLibre needs no key, so the site, and any partner site, works with no token.

To switch back to Mapbox, as doxa.life uses it today, set one setting plus the token, then start the server:

NUXT_PUBLIC_MAP_PROVIDER=mapbox NUXT_PUBLIC_MAPBOX_TOKEN=pk.your-token PORT=4611 bun run dev

On a deployed site, set the same two variables in its environment. Without a token, "mapbox" falls back to MapLibre, so a map always starts.

What is in this branch

/deep-research: the Deep Research gallery (the DX Maps mobilization maps in one app, the Experimental section included), filling the page below the header. Every tab has an info button that explains what the map does.
/research: DX Life's production page (fc4d622), with the research map on its own, now loaded from this site's own /dx-maps/, and under it one new line: "Want Deeper Research? See our Deep-Research Maps →", which links to /deep-research in the reader's language. The line is in all 11 of the site's locales.
/ and /pray: the engagement map and the prayer map (the simple map with those presets), as before.
public/dx-maps/: the DX Maps output folder, from DX Maps development eca1ecb4a.
The page never loads anything from api.mapbox.com; a map loads Mapbox itself, and only when Mapbox is chosen. A slow or blocked Mapbox cannot stop a map from appearing.

More detail: DX-MAPS-GALLERY.md.

3.3 KiB Raw Blame History