npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

fe-dev-server

v1.7.0

Published

a dev server for frontend developers

Downloads

19

Readme

FE Dev Server Build and Deploy

FE Dev Server target to help frontend web developers create view template, styles and js easily. It try the best to simulate real server environment which can help you to make you job done.

Features

  1. Various template engines and embedded page data.
  2. Url simulation
  3. Mock data in file
  4. Proxy configuration

Quick start

Install it as a command line tool with the following step:

Install module globally

$ npm install -g fe-dev-server

create project folder and get into the folder

$ mkdir workdir && cd workdir

initial the project folder

$ fds init

start up server

$ fds server

start up server & open browser

$ fds server -o

Also, it can be integrated into your own project as a node module.

var fds = require('fe-dev-server');

var app = fds({
    basePath: __dirname,
    mockFolder: 'data',
    port: 8001  
});

Routes

Routes is stored in routes.js as key/value pairs by default.

Sample:

module.exports = {
    // set /test route to test.html page, default http method is GET
    '/test':                    'test.html',
    
    // set /books route to books.pug template with GET method
    'GET::/books':              'books.pug',
    
    // set json api with a json file in mock folder
    'POST::/api/books':         'mock::books.json',
    
    // mock file can also be a js file, which has more power to do the customization
    'GET::/api/category':       'mock::category.js',

    // fds works with java template such as jsp;
    // before do this, you have to set enableJava to true in your fds-config.js file
    '/jsp-page':                'books.jsp',
    
    // it allow your route to proxy an online page
    '/proxy-api':               'http://www.github.com/zhex.json',
    
    // proxy can do fuzzy mapping;
    // in the setting, if you visit /books/hello, it will map to http://example.com/books/hello
    'ALL::/books/:pattern*':    'http://example.com/books/'
};

the rule is '[method]::[route_url]': '[template_file]'.

Allowed method: GET, POST, PUT, PATCH, DETELE

GET will be used if it is not specified.

If you want to setup an ajax api url, you can set the template to a json file. The server will look for the json/js file in view folder and send back it as a json object. the data in the view folder sounds not make sense. So if you want put the json/js file in the mock folder, then you can add a mock:: prefix in the template path, then the server will look for the file in mock folder.

If the mock file is a js file, then it is good to define as a module function:

module.exports = function (data, utils) {
    return {
        id: data.params.id,
        name: data.query.name || 'hello world',
        content: data.body.content
    };
};

The data.params is the match variable collection in the particular route; The data.query is the query data from request url, so you can easily test your page with different api return.

utils provide some easy to use method to handle the data.

available method:

  • utils.isObject(obj)
  • utils.isArray(obj)
  • utils.isFunc(obj)
  • utils.contains(array, item)
  • utils.serialize(obj)
  • utils.assign() - which is object-assign library
  • utils.moment() - which is moment library
  • utils.Mock - which is mockjs library

Also, you can add $$header in the data file to extend http response header, and using $$delay to set simulate the http connection delay.

{
    "$$header": {
        "x-access-token": "abcs"
    },
    "$$delay": 3000,
    "title": "hello world"
}

embedded template engines

Configuration

You can custom your configuration in fds-config.js file.

defaultConfig = {
    basePath: path.resolve(__dirname, './example'),
    publicFolder: 'public',
    viewFolder: 'views',
    mockFolder: 'mocks',
    routeFile: 'routes.js',
    port: 3000
}

basePath

The base path of the project, all other folder settings are related to base path.

viewFolder

default: 'views'

Where you can put your view template files.

mockFolder

default: 'mocks'

Save you mock data into this folder. each view template will have a matched json data file will be loaded automatcially.

For example: we have a ${viewFolder}/projects/index.html template, then data in ${viewFolder}/projects/index.json file will be auto loaded into the template.

publicFolder

default: 'public'

Where you can put your image, style and js files here. This folder is set by express.static()

routeFile

default: 'routes.js'

Routes mapping file

mockExts

default: ['.js', '.json']

Some people like to set mockFolder as the same as viewFolder for convinence reason, mockExts give you the ability to define your own mock file type to avoid the conflict issue. Also, the ext order in array demonstrate the priority from higher to lower.

port

default: 3000

Express server port

enableJava

default: true

Sometimes you don't need to support java templates, you can turn it off with this property to false.

livereload

default: true

livereload is awesome, it will refresh your browser automatically after anything changed. If you dont like this feature, you can set it to false to switch it off. also you can set it as a livereload option object;

open

default: { route: '/', browser: ['google chrome'] }

Browser setting allow you to open dev site automatically on server started with -o option in cli. It will open google chrome by default.

$ fds server -o

License

This project is licensed under the terms of the MIT license.