Git Product home page Git Product logo

sakura's Introduction

sakura: a minimal, classless CSS framework / theme.

npm

[Go to GitHub repository]

The cherry blossoms

The perfect blossom is a rare thing. You could spend your life looking for one, and it would not be a wasted life.

Just drop sakura.css into any webpage and go from an ugly-looking 1900s website to a pretty, modern website in literally 0 seconds.

It's easy to customize and build on top of sakura.

Sakura supports extremely easy theming using variables for duotone color scheming. It comes with several existing themes, which can be found in the css folder of this repository.

Demo

Compare a live page WITH and WITHOUT sakura.

Also, my blog is a nice place to check sakura in action with heavy text (it has a "change theme" button on the top as well):

Bookmark

Don't want to develop using sakura but instead want to use it on websites with outdated 90s design (i.e. no CSS)?

If so, enable sakura on any website using the following instructions:

Why? - Reasons to use sakura

How exactly does sakura help you? I had a discussion about this on the reddit thread.

  • Just drop it in, even on existing HTML content, to get a pretty-looking website (everything "just works")
  • Quick prototyping, especially when working on backend sites and can't yet be bothered to fidget with CSS/HTML
  • Building a quick (but pretty) site/blog for your best friend or aunt!
  • No need to remember tons of different class names for every other CSS framework
  • Works amazingly with markdown-generated HTML pages (eliminates the need for hacks like including .img img-responsive in <img></img> tags generated from markdown-parser
  • Wonderful for people who aren't really good or interested in design as sakura is nothing but a set of reasonable defaults

Installation

CDN (recommended):

  1. Simply add this in your <head> tag:

    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/sakura.css/css/sakura.css" type="text/css">

Manually:

  1. Download the file:

    wget "https://raw.githubusercontent.com/oxalorg/sakura/master/css/sakura.css"

    OR download directly: sakura.css

  2. Link it from HTML:

    <link rel="stylesheet" href="sakura.css" type="text/css">

Package Manager:

  1. Install from npm:

    npm install sakura.css
  2. Install from Yarn:

    yarn add sakura.css

(Optional) but recommended to use normalize.css to reset before using sakura.

Sites using sakura

If you're using sakura, please let me know or make a pull request adding in your name. I would be super happy!! ^_^

Theming

You can make your own themes by overriding some variables for colors.

Here is an example file: ./scss/sakura-earthly.scss:

/* Duotone color scheming:
   Uses blossom as the revealing/stark color
   Uses fade as the more prominent color
*/
$color-blossom: #338618;
$color-fade: #5e5e5e;

/* bg color is used for the background of the page
   bg-alt is used for code-blocks etc
*/
$color-bg: #f9f9f9;
$color-bg-alt: #C7E3BE;

/* color of all the text on the page */
$color-text: #4a4a4a;
$font-size-base: 1.8rem;

@import "main";

Dark mode

Add a media attribute as follows to choose a darker theme for dark mode.

<link rel="stylesheet" href="https://unpkg.com/sakura.css/css/sakura.css" media="screen" />
<link rel="stylesheet" href="https://unpkg.com/sakura.css/css/sakura-dark.css" media="screen and (prefers-color-scheme: dark)" />

Contributing

Please have a look at the instructions.

Contributors

Share some <3

Between our two lives there is also the life of the cherry blossom.

  • Basho Matsuo

Please leave a star. :)

sakura's People

Contributors

adriangrigore avatar atusy avatar beenotung avatar dannyfeliz avatar frostkiwi avatar hedgecox avatar indigotock avatar jolheiser avatar julienvanelian avatar laurens94 avatar lucas-deangelis avatar lucasew avatar mbluelander avatar michaelskyba avatar monkeyjunglejuice avatar nonwiz avatar oxalorg avatar pixelkritzel avatar reinforcezwei avatar rohanpadhye avatar roj1512 avatar rottencandy avatar sacredsatan avatar sapphicmoe avatar sausagenoods avatar spenserblack avatar traverseda avatar vincenz-e avatar yunruse avatar zhouzi avatar

Watchers

 avatar

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.