GithubHelp home page GithubHelp logo

khalidelsayed / swagger-ui-themes Goto Github PK

View Code? Open in Web Editor NEW

This project forked from ostranme/swagger-ui-themes

0.0 1.0 0.0 5.58 MB

:boom: A collection of css themes to spice up your Swagger docs

Home Page: http://meostrander.com/swagger-ui-themes/

CSS 100.00%

swagger-ui-themes's Introduction

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)

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

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.