Super Search Builder — Stage 1.1

Live website: https://markbeachill.github.io/supersearch-builder GitHub repository: https://github.com/markbeachill/supersearch-builder

A static GitHub Pages website for building standalone Super Search pages aimed at research. A Super Search page takes a single typed query and fans it out into many searches — one per site, database or engine — each opening that site's own results for your query.

This builder is a sibling of the Personal Start Page Creator. It shares the same philosophy: no account, no backend, no framework, no external library, and a standalone HTML file you own as the output.

Stage 1.1 update

• Searches now start as plain dark text and become blue underlined links once a query is typed — matching how the classic Super Search behaved.
• Added a centred masthead with a red "Super Search" prefix in a serif font, to distinguish a Super Search page from a start-page menu. The "show title" setting now controls this masthead.
• Darker body text, lighter grey backgrounds, and wider letter-spacing on section headings for readability.
• Queries are now encoded with + for spaces (e.g. climate+migration), matching the classic style and reading well in site searches.
• Added a site search builder: type a website address (e.g. economist.com) and get a Google site-search template …?q=site:economist.com+%s. Available both on the converter page and inside the builder's per-section panel. This is how most news and magazine searches work.
• New How it works page with a live interactive demo (type a query, get links).
• Renamed throughout: a entry is a search (not an "engine"); the old "How to add a search engine" guide is now Add a search and covers both the paste-a-link route and the site-search route.
• Added Mark's Super Search template, reconstructed from the classic setup with UEL library, Keenious and institutional setup links omitted.

What a Super Search page does

You type one query, for example climate migration, press Search all, and the page opens (or lists) a search on every engine you included:

• Google Scholar https://scholar.google.com/scholar?q=climate+migration
• JSTOR https://www.jstor.org/action/doSearch?Query=climate+migration
• PubMed https://pubmed.ncbi.nlm.nih.gov/?term=climate+migration
• …and as many more as you add.

The clever part is that search patterns vary between engines. The query goes in a different place each time: ?q=, ?Query=, ?search=, ?term=, ?search_query=, sometimes in the path, sometimes +-encoded and sometimes %20-encoded. The builder stores each engine as a search template with a %s token marking where the query goes, and the exported page substitutes your typed query into every template.

The two things you build with

• Search engine — a single entry: a label, a search-template URL containing %s, a section and a colour. Example template: https://core.ac.uk/search?q=%s.
• Section — a labelled group of engines (e.g. Academic, News, Repositories), matching the grouped layout of the original UEL Super Search.

The link converter

Researchers rarely know an engine's template URL. They do know how to run a search. So the builder includes a converter:

1. Run a real search on the target site for a memorable phrase, e.g. climate migration.
2. Copy the full results-page URL from the address bar.
3. Paste the URL into the converter and tell it the phrase you searched for.
4. The converter finds your phrase inside the URL — in the query string or the path, +-encoded or %20-encoded — replaces it with %s, and gives you a ready template you can add to a section with one click.

converter.html is a standalone page that does this, and the same converter is built into the builder's "Add engine from a search link" panel.

How "fan out" works in the exported page

A Super Search page cannot reliably open 40 browser tabs at once — browsers block bulk window.open as pop-ups. So the exported page supports two modes, chosen per page:

• Links mode (default, reliable): typing the query rewrites every engine button's href live, so each button opens that engine's results for the current query in a new tab when clicked. This is exactly how the original UEL Super Search behaves and works everywhere with no pop-up issues.
• Open-all mode (optional): an extra "Open all in this section" control attempts to open a section's engines in new tabs. The page warns that the browser may ask to allow pop-ups the first time.

GitHub Pages

Publish the project website from:

/docs

For a user's own published Super Search page, the simplest rule is:

Rename the saved Super Search page to index.html.

Then put index.html at the top of the chosen GitHub Pages publishing source:

/index.html        if publishing from the repository root
/docs/index.html   if publishing from /docs

Structure

docs/
  index.html              integrated public home page
  builder.html            light-wrapper builder app
  converter.html          standalone search-link → template converter
  how-it-works.html      normal site page with a live interactive demo
  add-a-search.html       guide: paste-a-link route and site-search route
  templates.html          jump-start research template catalogue
  about.html              about this tool
  help.html               help and notes
  assets/site.css         public site styling
  assets/converter.js     shared search-template engine (used by builder + converter)
  templates/*.json        starter Super Search configs
  templates/catalog.json  template catalogue index
  examples/*.html         exported demo Super Search pages

Config format

Menu config is JSON, versioned with a format key, the same way the start page builder versions its configs:

{
  "format": "supersearch-builder-v1",
  "title": "Research Super Search",
  "description": "One query, many research databases.",
  "filename": "supersearch.html",
  "columns": 3,
  "colours": "primary",
  "showTitle": true,
  "openMode": "links",
  "sections": [
    {
      "name": "Academic",
      "colour": "green",
      "engines": [
        { "label": "Google Scholar", "template": "https://scholar.google.com/scholar?q=%s" },
        { "label": "JSTOR", "template": "https://www.jstor.org/action/doSearch?Query=%s" }
      ]
    }
  ]
}

• template is a full URL containing exactly one %s token.
• openMode is "links" (default) or "openAll".
• Configs without openMode load safely and default to "links".
• colours defaults to "primary", showTitle to true, columns to 3.

File concepts

• Super Search page: the finished .html page used in a browser or published online.
• Menu config: the .json file that lets the builder reload sections, engines, colours, columns and settings later.
• Search template: a full URL with a %s token where the query is inserted.

Local testing

cd docs
python3 -m http.server 8000

Open http://localhost:8000.

Design rule

Public informational pages use the integrated site design. The builder uses only a light top-navigation wrapper. Exported Super Search pages remain standalone HTML and do not depend on the website design. The grouped section / coloured button / search-row layout is preserved from the original Super Search and the start page builder.

Relationship to the start page builder

This repository deliberately reuses the start page builder's structure, CSS approach, JSON config style, localStorage drafts, import/export pattern and standalone-export mechanism. The essential difference is that a link is a search template with a %s token rather than a fixed destination, and the exported page rewrites every link from one shared query box.