Giter VIP home page Giter VIP logo

svelma's Introduction

Svelma

Svelma is a set of UI components for Svelte based on the Bulma CSS framework.

Inspiration

Much thanks to the Buefy project! It provided the inspiration and lots of code examples for Svelma.. If you like Vue.js and Bulma, check it out.

Features

  • Extremely lightweight thanks to Svelte, a compile-only javascript framework. The bundle is 50K minified, 14K gzipped.
  • Components can be used independently, so a modern tree-shaking bundler will reduce the final bundle size even further.
  • Svelma does not bundle Bulma, so you are free to include it in your project however you wish, themes and all.

Documentation

See docs + demos site here

Quick Start

1. Create a svelte app from the template

https://github.com/sveltejs/template is a template repo for svelte. degit will scaffold the repo for you:

$ npx degit sveltejs/template my-svelma-project
$ cd my-svelma-project
$ npm install

NOTE: There are of course other ways to set up a project using svelte. This is just the quickest way to start.

2. Install svelma and dependencies via npm

Note that you'll need a CSS processing plugin for rollup so that you can import css files. Here we're using rollup-plugin-postcss. If you're going to use a <link> tag in your HTML you can skip the plugin and the import ... css statement below in step #2

$ npm install --save bulma svelma
$ npm install sass rollup-plugin-postcss --save-dev

Add the postcss plugin to your rollup config (I don't think the order really matters):

// rollup.config.js
import postcss from 'rollup-plugin-postcss'

// ...

export default {
  // ... 
  plugins: [
    svelte({
      // ...
    }),

    postcss(),
  }
}

3. Import Bulma's CSS and Svelma components

<!-- App.svelte -->
<script>
  import 'bulma/css/bulma.css'
  import { Button } from 'svelma'
</script>

<Button type="is-primary">I'm a Button!</Button>

4. Include Font Awesome icons

From CDN in your HTML page:

<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.3.1/css/all.css"></link>

...or as an npm package imported into your root component:

$ npm install --save @fortawesome/fontawesome-free
<!-- App.svelte -->
<script>
  import 'bulma/css/bulma.css'
  import '@fortawesome/fontawesome-free/css/all.css'
</script>

SSR

If you are doing server-side rendering with Sapper, you'll need to import the .svelte files directly so that your app can compile them, rather than importing from the compiled module.

i.e.:

import Button from 'svelma/src/components/Button.svelte'

instead of

import { Button } from 'svelma'

Development

  1. Clone this repo: git clone https://github.com/c0bra/svelma.git
  2. Install dependencies:
    1. npm i && (cd docs; npm i)
    2. npm install -g semantic-release-cli commitizen
  3. Start the automated build and automated docs: npm run dev
  4. Open url that console prints in your browser

Commit

$ git cz

Publish

NOTE: CI should publish new versions using semantic-release automatically

$ npm version <version>
$ npm publish

License

Code released under MIT license.

Copyright ©, Brian Hann.

svelma's People

Contributors

bradyjoslin avatar c0bra avatar dependabot[bot] avatar kroshilin avatar riverinyo avatar tiberiuc avatar

Watchers

 avatar  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.