CSS
Clone or download
ostranme Merge pull request #33 from gracefullight/develop
Material.css: Override opblock h4 span:after color
Latest commit 2f97991 Apr 23, 2018

README.md

Swagger UI Themes

Version 3.0.0

npm Bower

Swagger Docs are awesome. Why not make them look better!

Getting started

Download the swagger-ui-themes project and place the desired stylesheet into the source of your swagger-ui html. Use the 3.x or 2.x directories depending on what version of Swagger UI you have.

β”œβ”€β”€ 2.x
β”‚Β Β  β”œβ”€β”€ theme-feeling-blue.css
β”‚Β Β  β”œβ”€β”€ theme-flattop.css
β”‚Β Β  β”œβ”€β”€ theme-material.css
β”‚Β Β  β”œβ”€β”€ theme-monokai.css
β”‚Β Β  β”œβ”€β”€ theme-muted.css
β”‚Β Β  β”œβ”€β”€ theme-newspaper.css
β”‚Β Β  └── theme-outline.css
└── 3.x
    β”œβ”€β”€ theme-feeling-blue.css
    β”œβ”€β”€ theme-flattop.css
    β”œβ”€β”€ theme-material.css
    β”œβ”€β”€ theme-monokai.css
    β”œβ”€β”€ theme-muted.css
    β”œβ”€β”€ theme-newspaper.css
    └── theme-outline.css

In the <head> of your html, reference the location to your [theme].css

<link rel="stylesheet" href="path/to/swagger-ui-themes/css/theme-flattop.css">
  • For 3.x, make sure to either remove/comment out the link to swagger-ui.css or load the desired theme after to override the default Swagger UI styles.

    If you have issues loading themes with 3.x, try modifying the index.html to load the theme.css absolutely last right before the closing body or html tag.

    • [workaround] 3.x theme loading issue (#25)
  • For 2.x, make sure to either remove/comment out the link to screen.css or load the desired theme after to override the default Swagger UI styles.

Install with bower

$ bower install swagger-ui-themes

Install with npm

$ npm install swagger-ui-themes

3.x Themes

Material

Material Screenshot

Flattop

Flattop Screenshot

Muted

Muted Screenshot

Newspaper

Newspaper Screenshot

Outline

Outline Screenshot

Monokai

Monokai Screenshot

Feeling Blue

Feeling Blue Screenshot

2.x Themes

Material

Material Screenshot

Flattop

Flattop Screenshot

Muted

Muted Screenshot

Newspaper

Newspaper Screenshot

Outline

Outline Screenshot

Monokai

Monokai Screenshot

Feeling Blue

Feeling Blue Screenshot

Community Driven Tools

Name Description
swagger-ui-themes-extensions Chrome extension to apply swagger-ui themes (https://github.com/AMoreaux/swagger-ui-themes-extension)

Donate/Support

Show your love for swagger-ui-themes. Donations to the project are always welcomed :)

BTC Wallet Address: 1LE3fKWMtmk7mhCg8pz2Z1inEmanh4vAUM

ETH Wallet Address: 0x68bc05013EddaCD3b08296C4067E12783eff2CAE

LTC Wallet Address: LX4rrzvxsa7Uo1mytvThZqcRmWprXVFBnk

Contributing

If you want to add theme ideas or other fixes/changes, feel free to submit an issue.

Requesting new theme

  • Title your new issue Theme request: theme-name (e.g., Theme request: theme-nyan-cat).
  • Include a few use cases for your requested theme. How do you plan on using it?

License