Giter VIP home page Giter VIP logo

plug4's Introduction

Silex Plugin Starter

A good place to start writing a Silex plugin. It supports server and/or client side plugins, in Javascript and TypeScript. Check Silex developer docs if you need help or join the discussions in the forum

Start creating your plugin from src/main.js or src/main.ts, read the Development section

TODO for your plugin

Here is a list of things to do before distributing your plugin to Silex users

  • Replace silex-plugin-starter in all files with your plugin name
  • Choose Javascript or TypeScript: edit rollup configs and just change the input from main.ts to main.js
  • Choose client side and or server side: edit build script in package.json, add/remove npm run build:client or npm run builde:server
  • Tests: when writing tests for the client, add a "doc block" with @jest-environment jsdom
  • Automate npm publish with github actions: you need to set the package name in package.json and the action secret NPM_SECRET in github
  • Remove this "TODO" section and fill in the blanks in the rest of the README
  • Show some gif/demo if possible
  • Run npm test and npm run lint:fix, create a version with npm version patch then push to github with git push oringin main --follow-tags which will publish to npm thanks to github actions

Add a gif or a live demo of your plugin here

Installation

This is how to use the silex-plugin-starter plugin in your Silex instance or JS project

Add as a dependency

$ npm i --save @silexlabs/silex-plugin-starter

Add to Silex config (client or server)

import plugin from '@silexlabs/silex-plugin-starter'
// Or import YourPlugin from '../path/to/silex-plugin-starter'
// Or import YourPlugin from 'http://unpkg.com/your-plugin'
export default function(config, options) {
  config.addPlugin(plugin, {
    // ... plugin config ...
  })
};

Options

Option Description Default
option1 Description option default value

Development

Clone the repository

$ git clone https://github.com/silexlabs/silex-plugin-starter.git
$ cd silex-plugin-starter

Install dependencies

$ npm i

Build and watch for changes

$ npm run build:watch

Start the dev server on port 3000 with watch and debug

$ npm run dev

Publish a new version

$ npm test
$ npm run lint:fix
$ git commit -am "new feature"
$ npm version patch
$ git push origin main --follow-tags

License

MIT

plug4's People

Contributors

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