Skip to content

Latest commit

 

History

History
960 lines (568 loc) · 67.7 KB

CHANGELOG.md

File metadata and controls

960 lines (568 loc) · 67.7 KB

3.8.0 (2024-11-12)

This version introduces a new type DocSearchTransformClient to allow the transformSearchClient to use either the lite client, or the full algoliasearch client. Users are encouraged to use the lite client (import { liteClient } from 'algoliasearch/lite) to reduce bundle size.

Bug Fixes

  • types: use a minimal type for transformSearchClient (#2348) (08d9a37)

Features

  • a11y: add hotkeys to search input aria-label (#2337) (44aa7dc)

3.7.0 (2024-11-04)

Bug Fixes

3.6.3 (2024-10-31)

  • fix: upgrade algoliasearch to v5 (#2326) (93578a4), closes #2326
  • fix: use vite instead of parcel in the examples (#2329) (d360855), closes #2329
  • docs(showcase): Fix logos for ScalarDB and ScalarDL in showcase (#2317) (90f3c6a), closes #2317

3.6.2 (2024-09-27)

Bug Fixes

3.6.1 (2024-07-16)

Bug Fixes

3.6.0 (2024-03-06)

Bug Fixes

Features

3.5.2 (2023-08-11)

Fixes

  • Updates algoliasearch package version (cc90789)
  • Adds search-insights as options peer dependency (cc90789)

3.5.1 (2023-06-15)

Features

  • api: support Insights on search results click (#1916) (cacade4)

3.5.0 (2023-06-08)

Features

  • api: allow insights options to be forwarded to Autocomplete (#1904) (26691a5)

3.4.0 (2023-05-24)

Features

3.3.5 (2023-05-17)

Bug Fixes

  • support Chrome autofill when event.key is undefined (#1888) (3f15fdb), closes #1887

3.3.4 (2023-04-26)

Bug Fixes

  • prevent calling onClose() when shiftKey, ctrlKey or metaKey is pressed (#1870) (b9a3899)
  • type of lvl0 (#1859) (8f48ebb)

3.3.3 (2023-02-06)

Bug Fixes

  • Correctly type getMissingResultsUrl query as string (#1781) (379f163)

3.3.2 (2023-01-10)

Bug Fixes

3.3.1 (2022-12-27)

Bug Fixes

3.3.0 (2022-10-25)

Features

  • enable Cmd+K shortcut when caps lock is on (#1590) (d13ded1)

3.2.2 (2022-10-20)

Bug Fixes

3.2.1 (2022-08-16)

Bug Fixes

  • deps: make react an optional peer dependency in @docsearch/react (#1273) (eb44d0c)
  • dependencies 2022-08-08 (#1480) (587ccd1)

3.2.0 (2022-08-02)

Bug Fixes

Features

  • styles: set medium breakpoint to standarized value (#1446) (8e2e90e)

3.1.1 (2022-06-30)

Bug Fixes

  • js: use outDir to avoid ambient type definition creation (#1396) (4c924bc)
  • searchbutton: fix react production hydration error (#1384) (448192e)
  • deps: bump and fix autocomplete deps (#1416) (448192e)

3.1.0 (2022-05-18)

Bug Fixes

Features

3.0.0 (2022-02-22)

Breaking Change

Bug Fixes

3.0.0-alpha.50 (2022-02-03)

Bug Fixes

  • deps: update algoliasearch-autocomplete monorepo to v1.5.2 (#1225) (aa309f5)
  • deps: update dependency @svgr/webpack to v6 (#1219) (52d6927)
  • deps: update dependency postcss to v8.4.5 (#1205) (d348589)
  • deps: update dependency postcss-preset-env to v7.0.2 (#1228) (1a7093b)
  • deps: update dependency postcss-preset-env to v7.1.0 (#1240) (cbb14eb)
  • deps: update dependency postcss-preset-env to v7.2.0 (#1252) (b3288fe)
  • deps: update docusaurus monorepo to v2.0.0-beta.13 (#1226) (02025e5)
  • deps: update docusaurus monorepo to v2.0.0-beta.14 (#1238) (77f785d)
  • logo: empty utm campaign (#1259) (30ee161)

Features

  • noResults: allow providing URL to report missing results (#1289) (2c1fe7c)

v3.0.0-alpha.42 (2021-12-03)

Bug Fixes

  • deps: update dependency postcss to v8.3.11 (#1153) (0ddad32)
  • deps: update dependency postcss-import to v14 (#1155) (ebaf66e)
  • deps: update dependency postcss-preset-env to v7 (#1194) (96af398)
  • deps: update docusaurus monorepo to v2.0.0-beta.9 (#1166) (5aed646)
  • discord: update invite link (510cbc6)
  • DocSearchProps: type searchParameters (#1200) (80677fd)
  • examples: use new infra credentials (65d9414)
  • issue template: update codesandbox link (891fd88)

Features

  • translations: expose Button and Modal translations (#1183) (ef13dea)

v3.0.0-alpha.41 (2021-10-18)

Bug Fixes

Features

v3.0.0-alpha.40 (2021-08-23)

Bug Fixes

  • ci: update config file (#1040) (4673f00)
  • removeHighlightTags: prevent destructuring undefined object (#1039) (6a6f7f6)

v3.0.0-alpha.39 (2021-07-23)

Bug Fixes

v3.0.0-alpha.38 (2021-07-23)

Bug Fixes

v3.0.0-alpha.37 (2021-07-09)

Bug Fixes

v3.0.0-alpha.36 (2021-04-14)

Bug Fixes

  • escapedResults: fix undefined _highlightResult (#1003) (16e6558)

3.0.0-alpha.35 (2021-04-12)

Bug Fixes

3.0.0-alpha.34 (2021-03-09)

Bug Fixes

  • deps: Update and pin Autocomplete to the latest version (#999) (1421077)

3.0.0-alpha.33 (2021-02-05)

Bug Fixes

  • use spans inside button tag instead of divs (#994) (f5c2a27)
  • css: remove sideEffects package field (#991) (9216ffa)
  • website: Sync tailwind darkmode class with docusaurus theme context (3ade29f)

Features

  • add translations prop to search button (#995) (44f5c7b)

3.0.0-alpha.32 (2020-12-01)

Bug Fixes

  • highlight first item by default (777bc8e)

3.0.0-alpha.31 (2020-11-25)

Bug Fixes

  • display keyboard shortcuts when platform exists (79f5b27)

3.0.0-alpha.30 (2020-11-25)

Bug Fixes

3.0.0-alpha.29 (2020-11-25)

This version follows 1.0.0-alpha.28.

Bug Fixes

  • core: add type search to getInputProps (9c1b040)
  • css: fixed Modal height undefined on Gecko (77a39a6)
  • css: don't display key shortcuts on mobile (1957f5a)
  • css: enforce no margin on DocSearch form (f5947a9)
  • css: firefox placeholder opacity (43ea375)
  • css: overflow overlay not supported on gecko (cca7700)
  • css: scroll windows (c0baaa6)
  • css: separate docusaurus css variables (faf6ef1)
  • deps: update dependency autocomplete.js to v0.37.0 (#806) (26e45c7)
  • deps: update failling yarn.lock (#957) (36ba461)
  • design: animation + spacing search button (a73d050)
  • design: contrast + darkmode (ba6bdde)
  • design: error screen, loading indicator, no results links (67a2b3c)
  • design: footer, hit spacing (7ef73c3)
  • design: hovers + tree icons (92fa12d)
  • design: icons (3219559)
  • design: improvements from feedbacks (c9273bf)
  • design: mobile (3e1b503)
  • design: mobile scroll and source zindex (f2e9eb9)
  • design: modal height, no results screen (b884838)
  • design: No results cosmetics (aa71abd)
  • design: no results, empty screen + details (cf7864d)
  • design: tablet responsive (a97199a)
  • docsearch: add index name to localStorage key (294c7cf)
  • docsearch: add padding to dropdown when no recent searches (f214d8d)
  • docsearch: allow a single instance to open (928b9ca)
  • docsearch: always use aria-expanded to true (262ddcb)
  • docsearch: capture mousedown event to close modal (f9247b9), closes /github.com/facebook/react-native-website/pull/2139#issuecomment-678330203
  • docsearch: do not render Screen when loading or stalled (39e72c4)
  • docsearch: don't add search to recent searches if favorited (f00672a)
  • docsearch: don't blur input on submit (ecda3d3)
  • docsearch: don't display items when no suggestions (4f96cdb)
  • docsearch: don't focus input if initial query (80983f5)
  • docsearch: don't open modal on / when editing text (45cf5c3)
  • docsearch: don't request Algolia on start screen (e661435)
  • docsearch: drop the "..." (bf86a1d)
  • docsearch: fix vanilla DocSearch types (5ccaead)
  • docsearch: focus input on Selection Search (dfa63df)
  • docsearch: group search button elements in containers (#74) (8640418)
  • docsearch: hide search suggestions if none (d7d6984)
  • docsearch: hoist transformItems default value (1b9952f)
  • docsearch: limit number of searches retrieved (9bac38c)
  • docsearch: limit query size (49c6347)
  • docsearch: make sure there are search suggestions before showing them (ef3566f)
  • docsearch: pass autoFocus prop to autocomplete for mobiles (4ea64b3)
  • docsearch: provide autocomplete ID for HTML attributes (a86a368)
  • docsearch: remove data-cy attributes (a9f13dd)
  • docsearch: remove blur effect to avoid performance issues (ea9c700)
  • docsearch: remove Docusaurus style (2ab1d0a)
  • docsearch: remove recent search when favorited (858a498)
  • docsearch: remove theme media query (dde883e)
  • docsearch: rename DocSearch-Button CSS class (a738af0)
  • docsearch: rename DocSearch-Button CSS class (8588b96)
  • docsearch: support initial query (cf84a25)
  • docsearch: update local storage key (db4bb37)
  • docsearch: update search suggestions when new lvl0s are encountered (3513478)
  • docsearch: use scrollTo when unmounting modal (1f9deb1)
  • docsearch: use scrollTop on body (1ef1947)
  • docsearch: use absolute URLs (3d95664)
  • docsearch: use Preact alias in Babel config (4acf723)
  • DocSearch: extend dropdown to fill the viewport height (#72) (a8fb063)
  • dosearch: don't add distinct search parameter (9893bb3)
  • react: make navigator optional (f228c11)
  • react: update enterkeyhint to enterKeyHint (0fadc8b)
  • search: hide content when `disableUserPersonalization (1cec65b)
  • re-export styles from style entry (5db7483)
  • use correct url (#936) (978df0e)
  • homepage: correct small issues (#921) (7fb619b)
  • homepage: make logo inline block (#887) (7a6f0a1)
  • website: memoize onInput callback (5411367)

Features

  • push keyboard buttons till client (#983) (9e4c69d), closes facebook/docusaurus#3682
  • select query when coming from a selection search (b3ee1cc)
  • update Autocomplete version (9a38842)
  • design: icon actions (6eca639)
  • design: new error icons + update icons + update light shadows / searchbox (2520895)
  • design: new icons (3cc88fa)
  • docsearch: add / keyboard shortcut (5725023)
  • docsearch: add aria-label to search button (f75e1cc)
  • docsearch: add DocSearch component (65a98b0)
  • docsearch: add enterkeyhint to go (1a0cbbf)
  • docsearch: add hitComponent and transformItems options (6ad1848)
  • docsearch: add useDocSearchKeyboardEvents API (adadacd)
  • docsearch: add DocSearch for Docusaurus (#39) (fa42ab2)
  • docsearch: add recent searches (#40) (4c0aa3b)
  • docsearch: add search suggestions (a448e9e)
  • docsearch: allow placeholder customization (7d62c6f)
  • docsearch: animate cards on action (a917e60)
  • docsearch: append modal to body (935aa81)
  • docsearch: attach docsearch.js user agent to vanilla renderer (f9398c4)
  • docsearch: attach docsearch.js user agent to vanilla renderer (267c22f)
  • docsearch: catch retry errors in the search client (ca8e410)
  • docsearch: display 5 hits per category maximum (e589657)
  • docsearch: display more recent searches when no favorites (164a0ce)
  • docsearch: export DocSearch types (159ef8b)
  • docsearch: forward props to autocomplete-core (26a4cc0)
  • docsearch: introduce disableUserPersonalization API (a40cc03)
  • docsearch: introduce initialScrollY option (bf4dc9a)
  • docsearch: introduce resultsFooterComponent option (9eaf18a)
  • docsearch: introduce transformSearchClient API (70b4de6)
  • docsearch: introduce DocSearch.js v3 (#56) (86a6a5d)
  • docsearch: introduce DocSearch.js v3 (#56) (c7f2645)
  • docsearch: introduce DocSearch.js v3 (#56) (a358695)
  • docsearch: introduce favorite searches (708b470)
  • docsearch: introduce Selection Search (f944f30)
  • docsearch: save content record hit parent in recent searches (3c5b4ff)
  • docsearch: save content record hit parent in recent searches (4d743bc)
  • docsearch: support initialQuery (8109206), closes #51
  • docsearch: support keyboard on focus on default integration (92e2565)
  • docsearch: support typing query when search button is focused (#54) (929b1c6)
  • docsearch: track docsearch-react UA (715bc4f)
  • docsearch: track docsearch-react UA (79a972b)
  • docsearch: trap focus in modal (ec7df43)
  • docsearch: update missing results issue link (b904ff6)
  • docsearch: use relative URLs (352592e)
  • DocSearch: add DocSearch CSS class to DocSearch elements (26bc858)
  • docusaurus: import DocSearch modal on hover (4b007b6)
  • website: lazy load DocSearch styles (8733274)
  • website: lazy load DocSearch styles (9a21885)
  • create clean exports (dbcebed)
  • redirect to https://docsearch.algolia.com (#926) (4c32b6f)

2.6.3 (2019-05-13)

Bug Fixes

  • docsearch input should have aria-label (a11y) (#687) (59d21f5)
  • search input a11y issue (#679) (a68d2a4)
  • deps: update dependency autocomplete.js to v0.35.0 (2d67a21)
  • deps: update dependency autocomplete.js to v0.36.0 (bbd4ef5)
  • security: Fix dependencies to avoid infected event-stream (9f93ffb)

Reverts

  • Revert "fix: search input a11y issue (#679)" (#686) (c0e9e19), closes #679 #686

2.6.2 (2018-11-22)

Features

  • ctrl-click: Enable Ctrl-Click on suggestions (#542) (a470c48)

2.6.1 (2018-11-07)

2.6.0 (2018-11-07)

Bug Fixes

  • deps: update dependency algolia-aerial to v1.3.4 (7e72fe0)
  • deps: update dependency algolia-aerial to v1.5.3 (665438e)
  • deps: update dependency algolia-frontend-components to v0.0.35 (bd5c03f)
  • deps: update dependency autocomplete.js to ^0.30.0 (21eb76a)
  • deps: update dependency autocomplete.js to ^0.31.0 (6c65eb2)
  • deps: update dependency chalk to v2 (#323) (f8962bd)
  • deps: update dependency deepmerge to v2 (#324) (db212d0)
  • deps: update dependency progress to v2 (#325) (a99347a)
  • wording: fixed case of DocSearch (#262) (d451545)

Features

  • css: Update menu on small screen (b5733d2)
  • docsearch: Add custom classes on titles for better crawling (fc79098)

Reverts

  • Revert "Revert "doc(site): Fixed typos (#277)" (#278)" (#279) (498675f), closes #277 #278 #279
  • Revert "doc(site): Fixed typos (#277)" (#278) (883894f), closes #277 #278

2.5.2 (2017-12-07)

2.5.1 (2017-11-28)

2.5.0 (2017-11-28)

Bug Fixes

  • autocompleteOptions: allow cssClasses options (#246) (6de70c3)

Features

  • global: Add responsive feature to the dropdown (777d2d4)

2.4.1 (2017-08-08)

2.4.0 (2017-08-08)

2.3.3 (2017-03-27)

Bug Fixes

  • build: fix badly handled webpack upgrade (3cbfbb1)

2.3.2 (2017-03-27)

2.3.1 (2017-02-23)

2.3.0 (2017-02-08)

2.2.1 (2017-01-11)

2.2.0 (2016-12-13)

2.1.8 (2016-10-04)

2.1.7 (2016-10-03)

Bug Fixes

2.1.6 (2016-10-02)

2.1.5 (2016-09-15)

Bug Fixes

  • empty: query should be escaped (self-XSS) (#147) (3aed41b)

2.1.4 (2016-08-03)

2.1.3 (2016-08-03)

2.1.2 (2016-07-22)

2.1.1 (2016-07-22)

2.1.0 (2016-07-07)

Bug Fixes

2.0.7 (2016-06-28)

2.0.6 (2016-06-28)

Bug Fixes

Features

2.0.5 (2016-06-21)

Bug Fixes

  • DOM: potential issue with simple layout if there is lvl0, lvl2 but no lvl1 (57c0101)

2.0.4 (2016-06-21)

Features

  • DOM: split simple and collumns template (2a3b7eb)

2.0.3 (2016-06-20)

2.0.2 (2016-06-14)

Features

  • dom: better handling of simple design (6bba640)

2.0.1 (2016-06-14)

2.0.0 (2016-06-14)

Features

1.3.0 (2016-06-12)

1.2.0 (2016-06-10)

Features

1.1.3 (2016-04-04)

Bug Fixes

  • autocomplete.js: upgrade the underlying autocomplete.js to ensur… (4d7022e), closes #89

1.1.2 (2016-03-24)

Features

  • website: React 🙌, popped out on the top with React (db9c100)

1.1.1 (2016-03-16)

Bug Fixes

  • algoliaOptions: ensure we keep default options (b284dda), closes #78
  • autocomplete: auto select top result (473824a), closes #81
  • dev: Fixed the dev example, targeting an existing index (df13e34)
  • website: responsive logo (b856d67)

Features

  • serve: Add npm run serve to expose js and css locally (31e5d13)
  • website: community header (366cc0d)
  • website: Logo Update - Og screen + favicon (c7eb54a)
  • website: removed demos (6d8eb34)
  • website: update (9498e3b)
  • website: updated logo (fa413d9)

1.1.0 (2016-02-01)

Bug Fixes

  • dropdown: Visually group suggestions together (592c8f2)

Features

  • website: ensure the inputs are mandatory (e59d132)

1.0.2 (2015-12-28)

Bug Fixes

  • debut: do not enable debug by default (188f49e)
  • url: Removes concatenation of URL with hash if it contains a hash (348df1c), closes #53
  • usage: fixed usage to match the latest prototype version (f6edc9e)

1.0.1 (2015-12-24)

Bug Fixes

  • handleSelected: ensure we're calling setVal on the right object (31abbd7), closes #51

1.0.0 (2015-12-24)

Bug Fixes

  • isSubCategoryHeader: ensure we hide the content of the left column if this flag is not set (0e04ce4), closes #47

0.0.7 (2015-12-22)

Bug Fixes

  • appId: Allow passing a custom appId (e1777d3), closes #21
  • css: Renaming all ads- prefix to algolia-docsearch- (c6fc53f)

0.0.6 (2015-12-16)

0.0.5 (2015-12-16)

0.0.4 (2015-12-16)

0.0.3 (2015-12-16)

0.0.2 (2015-12-16)

Bug Fixes

  • colors: Reduce number of colors (125d1c7)
  • snippet: Fix typo in method name (751dfdb)

Features

  • gh-pages: Add gh-pages deploy script (ab1a299)
  • main: Add main wrapper (bdac9dd)
  • styling: Set grayscale as default, add styling as external file (5d8cca8)

2.6.3 (2019-05-13)

Bug Fixes

  • deps: update dependency autocomplete.js to v0.35.0 (2d67a21)
  • deps: update dependency autocomplete.js to v0.36.0 (bbd4ef5)
  • security: Fix dependencies to avoid infected event-stream (9f93ffb)
  • docsearch input should have aria-label (a11y) (#687) (59d21f5)
  • search input a11y issue (#679) (a68d2a4)

2.6.2 (2018-11-22)

Features

  • ctrl-click: Enable Ctrl-Click on suggestions (#542) (a470c48)

2.6.1 (2018-11-07)

2.6.0 (2018-11-07)

Bug Fixes

  • deps: update dependency algolia-aerial to v1.3.4 (7e72fe0)
  • deps: update dependency algolia-aerial to v1.5.3 (665438e)
  • deps: update dependency algolia-frontend-components to v0.0.35 (bd5c03f)
  • deps: update dependency autocomplete.js to ^0.30.0 (21eb76a)
  • deps: update dependency autocomplete.js to ^0.31.0 (6c65eb2)
  • deps: update dependency chalk to v2 (#323) (f8962bd)
  • deps: update dependency deepmerge to v2 (#324) (db212d0)
  • deps: update dependency progress to v2 (#325) (a99347a)
  • wording: fixed case of DocSearch (#262) (d451545)

Features

  • css: Update menu on small screen (b5733d2)
  • docsearch: Add custom classes on titles for better crawling (fc79098)

2.5.2 (2017-12-07)

2.5.1 (2017-11-28)

2.5.0 (2017-11-28)

Bug Fixes

  • autocompleteOptions: allow cssClasses options (#246) (6de70c3)

Features

  • global: Add responsive feature to the dropdown (777d2d4)

2.4.1 (2017-08-08)

2.4.0 (2017-08-08)

2.3.3 (2017-03-27)

Bug Fixes

  • build: fix badly handled webpack upgrade (3cbfbb1)

2.3.2 (2017-03-27)

2.3.1 (2017-02-23)

2.3.0 (2017-02-08)

2.2.1 (2017-01-11)

2.2.0 (2016-12-13)

2.1.8 (2016-10-04)

2.1.7 (2016-10-03)

Bug Fixes

2.1.6 (2016-10-02)

2.1.5 (2016-09-15)

Bug Fixes

  • empty: query should be escaped (self-XSS) (#147) (3aed41b)

2.1.4 (2016-08-03)

2.1.3 (2016-08-03)

2.1.2 (2016-07-22)

2.1.1 (2016-07-22)

2.1.0 (2016-07-07)

Bug Fixes

2.0.7 (2016-06-28)

2.0.6 (2016-06-28)

Bug Fixes

Features

2.0.5 (2016-06-21)

Bug Fixes

  • DOM: potential issue with simple layout if there is lvl0, lvl2 but no lvl1 (57c0101)

2.0.4 (2016-06-21)

Features

  • DOM: split simple and collumns template (2a3b7eb)

2.0.3 (2016-06-20)

2.0.2 (2016-06-14)

Features

  • dom: better handling of simple design (6bba640)

2.0.1 (2016-06-14)

2.0.0 (2016-06-14)

Features

1.3.0 (2016-06-12)

1.2.0 (2016-06-10)

Features

1.1.3 (2016-04-04)

Bug Fixes

  • autocomplete.js: upgrade the underlying autocomplete.js to ensur… (4d7022e), closes #89

1.1.2 (2016-03-24)

Features

  • website: React 🙌, popped out on the top with React (db9c100)

1.1.1 (2016-03-16)

Bug Fixes

  • algoliaOptions: ensure we keep default options (b284dda), closes #78
  • autocomplete: auto select top result (473824a), closes #81
  • dev: Fixed the dev example, targeting an existing index (df13e34)
  • website: responsive logo (b856d67)

Features

  • serve: Add npm run serve to expose js and css locally (31e5d13)
  • website: community header (366cc0d)
  • website: Logo Update - Og screen + favicon (c7eb54a)
  • website: removed demos (6d8eb34)
  • website: update (9498e3b)
  • website: updated logo (fa413d9)

1.1.0 (2016-02-01)

Bug Fixes

  • dropdown: Visually group suggestions together (592c8f2)

Features

  • website: ensure the inputs are mandatory (e59d132)

1.0.2 (2015-12-28)

Bug Fixes

  • debut: do not enable debug by default (188f49e)
  • url: Removes concatenation of URL with hash if it contains a hash (348df1c), closes #53
  • usage: fixed usage to match the latest prototype version (f6edc9e)

1.0.1 (2015-12-24)

Bug Fixes

  • handleSelected: ensure we're calling setVal on the right object (31abbd7), closes #51

1.0.0 (2015-12-24)

Bug Fixes

  • isSubCategoryHeader: ensure we hide the content of the left column if this flag is not set (0e04ce4), closes #47

0.0.7 (2015-12-22)

Bug Fixes

  • appId: Allow passing a custom appId (e1777d3), closes #21
  • css: Renaming all ads- prefix to algolia-docsearch- (c6fc53f)

0.0.6 (2015-12-16)

0.0.5 (2015-12-16)

0.0.4 (2015-12-16)

0.0.3 (2015-12-16)

0.0.2 (2015-12-16)

Bug Fixes

  • colors: Reduce number of colors (125d1c7)
  • snippet: Fix typo in method name (751dfdb)

Features

  • gh-pages: Add gh-pages deploy script (ab1a299)
  • main: Add main wrapper (bdac9dd)
  • styling: Set grayscale as default, add styling as external file (5d8cca8)