Skip to content
/ smelte Public
forked from matyunya/smelte

UI framework with material components built with Svelte and Tailwind CSS

License

Notifications You must be signed in to change notification settings

leokhoa/smelte

 
 

Repository files navigation

Smelte

license downloads version

Demo

Smelte is a UI framework built on top of Svelte and Tailwind CSS using Material Design spec (hence the name). It comes with many components and utility functions making it easy to build beautiful responsive layouts while keeping bundle size and performance at check all thanks to Svelte.

Installation

Clone the project's template, install the dependencies and write some pretty code!

npx degit matyunya/smelte-sapper-template my-svelte-project
cd my-svelte-project
yarn && yarn dev
(or npm install && npm run dev)

If you don't want to use sapper you can use raw template:

npx degit matyunya/smelte-template my-svelte-project

Adding to existing project

Basically you need to add Tailwind to your project and import Smelte's configuration.

First add the dependencies:

yarn add smelte tailwindcss rollup-plugin-postcss svelte-preprocess @fullhuman/postcss-purgecss postcss-import tailwindcss-elevation

Add following to postcss.config.js in your project's root directory

const production = !process.env.ROLLUP_WATCH;
const purgecss = require("@fullhuman/postcss-purgecss");

module.exports = {
  plugins: [
    require("postcss-import")(),
    require("tailwindcss")("./tailwind.config.js"),
    require("autoprefixer"),
    production &&
      purgecss({
        content: ["./**/*.html", "./**/*.svelte"],
        defaultExtractor: content => content.match(/[A-Za-z0-9-_:/]+/g) || [],
        whitelistPatterns: [
          // for JS ripple
          /ripple/
        ]
      })
  ]
};
  

Then to tailwind.config.js

// Extend your config here.
const config = require("smelte/tailwind.config.js");

module.exports = config;

Add postcss to your Rollup config:

import postcss from "rollup-plugin-postcss";
import autoPreprocess from "svelte-preprocess";

...

plugins: [
  svelte({
    preprocess: autoPreprocess({
      postcss: true
    }),
    // enable run-time checks when not in production
    dev: !production,
    // we'll extract any component CSS out into
    // a separate file — better for performance
    css: css => {
      css.write("public/bundle.css");
    }
  }),
  postcss({
    extract: "public/utils.css"
  }),

Add exported css file to public/index.html:

<link rel='stylesheet' href='/utils.css'>

Create tailwind.css in src folder with this line:

@import 'smelte/src/tailwind';

And import it in your src/main.js:

import './tailwind.css';

That's it! The process is quite tedious at the moment. Please send feedback if you know how to make it better.

Components

  • Text field
  • Button
  • Select
  • Checkbox
  • Radio
  • List
  • Chip
  • Menu
  • Navigation drawer
  • Snackbar
  • Dialog
  • Card
  • Slider
  • Proper customization via class props
  • Data table
  • Autocomplete
  • Tooltip
  • Revise events (on:change, on:focus, on:input...)
  • Treeview
  • Form
  • Date picker
  • Stepper
  • Upload
  • Rating
  • Pagination
  • Breadcrumbs

Features

  • Default typography per Material design spec
  • Material icons
  • CSS ripple animation
  • Image lazy loading
  • Now SSR deployment
  • Color palette generator
  • Improve Purge CSS
  • Theming
  • Image processing (done here)
  • Svelte template (without Sapper)
  • JS ripple animation
  • Dark mode
  • Other icons
  • Document API
  • IE 11 support

About

UI framework with material components built with Svelte and Tailwind CSS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 69.4%
  • JavaScript 27.2%
  • CSS 3.4%