starship/docs/presets/README.md

# Presets

Here is a collection of community-submitted configuration presets for Starship.
If you have a preset to share, please [submit a PR](https://github.com/starship/starship/edit/master/docs/presets/README.md) updating this file! 😊

To get details on how to use a preset, simply click on the image.

## [Nerd Font Symbols](./nerd-font.md)

This preset changes the symbols for each module to use Nerd Font symbols.

[![Screenshot of Nerd Font Symbols preset](/presets/img/nerd-font-symbols.png "Click to view Nerd Font Symbols preset")](./nerd-font)

## [Bracketed Segments](./bracketed-segments.md)

This preset changes the format of all the built-in modules to show their segment
in brackets instead of using the default Starship wording ("via", "on", etc.).

[![Screenshot of Bracketed Segments preset](/presets/img/bracketed-segments.png "Click to view Bracketed Segments preset")](./bracketed-segments)

## [Plain Text Symbols](./plain-text.md)

This preset changes the symbols for each module into plain text. Great if you
don't have access to Unicode.

[![Screenshot of Plain Text Symbols preset](/presets/img/plain-text-symbols.png "Click to view Plain Text Symbols preset")](./plain-text)

## [No Runtime Versions](./no-runtimes.md)

This preset hides the version of language runtimes. If you work in containers or virtualized environments, this one is for you!

[![Screenshot of Hide Runtime Versions preset](/presets/img/no-runtime-versions.png "Click to view No Runtime Versions preset")](./no-runtimes)

## [Pure Prompt](./pure-preset.md)

This preset emulates the look and behavior of [Pure](https://github.com/sindresorhus/pure).

[![Screenshot of Pure preset](/presets/img/pure-preset.png "Click to view Pure Prompt preset")](./pure-preset)

## [Pastel Powerline](./pastel-powerline.md)

This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-my-posh/blob/main/themes/M365Princess.omp.json).
It also shows how path substitution works in starship.

[![Screenshot of Pastel Powerline preset](/presets/img/pastel-powerline.png "Click to view Pure Prompt preset")](./pastel-powerline)
docs: Add a "Presets" page to the website (#783) 2019-12-24 03:32:48 +00:00			`# Presets`

			`Here is a collection of community-submitted configuration presets for Starship.`
			`If you have a preset to share, please [submit a PR](https://github.com/starship/starship/edit/master/docs/presets/README.md) updating this file! 😊`

docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`To get details on how to use a preset, simply click on the image.`
docs: Add a "Presets" page to the website (#783) 2019-12-24 03:32:48 +00:00
fix(docs): fix and cleanup VuePress config (#3738) * Use relative links * Remove migrating link * Fix zh-* config * Adjust how sidebar is generated * Enable evergreen * Format * Update docs/.vuepress/config.js Co-authored-by: David Knaack <davidkna@users.noreply.github.com> Co-authored-by: David Knaack <davidkna@users.noreply.github.com> 2022-03-11 20:48:44 +00:00			`## [Nerd Font Symbols](./nerd-font.md)`
docs: Add a "Presets" page to the website (#783) 2019-12-24 03:32:48 +00:00
docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`This preset changes the symbols for each module to use Nerd Font symbols.`
docs: Add a "Presets" page to the website (#783) 2019-12-24 03:32:48 +00:00
docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`[![Screenshot of Nerd Font Symbols preset](/presets/img/nerd-font-symbols.png "Click to view Nerd Font Symbols preset")](./nerd-font)`
docs: Add a "Presets" page to the website (#783) 2019-12-24 03:32:48 +00:00
fix(docs): fix and cleanup VuePress config (#3738) * Use relative links * Remove migrating link * Fix zh-* config * Adjust how sidebar is generated * Enable evergreen * Format * Update docs/.vuepress/config.js Co-authored-by: David Knaack <davidkna@users.noreply.github.com> Co-authored-by: David Knaack <davidkna@users.noreply.github.com> 2022-03-11 20:48:44 +00:00			`## [Bracketed Segments](./bracketed-segments.md)`
docs: New preset "Bracketed Segments" (#2747) This preset changes all the built-in formats to show their segment in brackets instead of using the default Starship wording ("via", "on", etc.). 2021-05-20 19:36:48 +00:00
			`This preset changes the format of all the built-in modules to show their segment`
			`in brackets instead of using the default Starship wording ("via", "on", etc.).`

docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`[![Screenshot of Bracketed Segments preset](/presets/img/bracketed-segments.png "Click to view Bracketed Segments preset")](./bracketed-segments)`
docs(preset): New preset "Plain Text Symbol" (#2749) * Add plain text preset * Add git symbols to plain text symbols 2021-05-22 17:08:21 +00:00
fix(docs): fix and cleanup VuePress config (#3738) * Use relative links * Remove migrating link * Fix zh-* config * Adjust how sidebar is generated * Enable evergreen * Format * Update docs/.vuepress/config.js Co-authored-by: David Knaack <davidkna@users.noreply.github.com> Co-authored-by: David Knaack <davidkna@users.noreply.github.com> 2022-03-11 20:48:44 +00:00			`## [Plain Text Symbols](./plain-text.md)`
docs(preset): New preset "Plain Text Symbol" (#2749) * Add plain text preset * Add git symbols to plain text symbols 2021-05-22 17:08:21 +00:00
docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`This preset changes the symbols for each module into plain text. Great if you`
			`don't have access to Unicode.`
docs(preset): New preset "Plain Text Symbol" (#2749) * Add plain text preset * Add git symbols to plain text symbols 2021-05-22 17:08:21 +00:00
docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`[![Screenshot of Plain Text Symbols preset](/presets/img/plain-text-symbols.png "Click to view Plain Text Symbols preset")](./plain-text)`
docs(preset): New preset "Plain Text Symbol" (#2749) * Add plain text preset * Add git symbols to plain text symbols 2021-05-22 17:08:21 +00:00
fix(docs): fix and cleanup VuePress config (#3738) * Use relative links * Remove migrating link * Fix zh-* config * Adjust how sidebar is generated * Enable evergreen * Format * Update docs/.vuepress/config.js Co-authored-by: David Knaack <davidkna@users.noreply.github.com> Co-authored-by: David Knaack <davidkna@users.noreply.github.com> 2022-03-11 20:48:44 +00:00			`## [No Runtime Versions](./no-runtimes.md)`
docs(preset): add Hide Runtime Versions preset (#2854) 2021-07-19 18:30:24 +00:00
			`This preset hides the version of language runtimes. If you work in containers or virtualized environments, this one is for you!`

docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`[![Screenshot of Hide Runtime Versions preset](/presets/img/no-runtime-versions.png "Click to view No Runtime Versions preset")](./no-runtimes)`
docs(preset): add Hide Runtime Versions preset (#2854) 2021-07-19 18:30:24 +00:00
fix(docs): fix and cleanup VuePress config (#3738) * Use relative links * Remove migrating link * Fix zh-* config * Adjust how sidebar is generated * Enable evergreen * Format * Update docs/.vuepress/config.js Co-authored-by: David Knaack <davidkna@users.noreply.github.com> Co-authored-by: David Knaack <davidkna@users.noreply.github.com> 2022-03-11 20:48:44 +00:00			`## [Pure Prompt](./pure-preset.md)`
docs: add Pure prompt preset (#3066) 2021-10-01 00:03:45 +00:00
			`This preset emulates the look and behavior of [Pure](https://github.com/sindresorhus/pure).`

docs: Update Preset system with several additional features (#3683) * New preset system * Add Rust to NerdFonts preset * Add more links and access Add image titles and links in headers to make things more accessible. * Shrink + optimize PNG images 2022-03-08 21:54:26 +00:00			`[![Screenshot of Pure preset](/presets/img/pure-preset.png "Click to view Pure Prompt preset")](./pure-preset)`
docs(preset): add Pastel Powerline preset (#3761) Co-authored-by: Matan Kushner <hello@matchai.dev> 2022-03-18 17:24:54 +00:00
			`## [Pastel Powerline](./pastel-powerline.md)`

			`This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-my-posh/blob/main/themes/M365Princess.omp.json).`
			`It also shows how path substitution works in starship.`

			`[![Screenshot of Pastel Powerline preset](/presets/img/pastel-powerline.png "Click to view Pure Prompt preset")](./pastel-powerline)`