# exseed

> A highly extensible nodejs framework

Latest version **0.2.2** (published 2016-02-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install exseed
pnpm add exseed
yarn add exseed
bun add exseed
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.2 |
| Published | 2016-02-16 |
| First published | 2015-11-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Weng, Chih-Ping |
| Maintainers | gocreating |
| Keywords | node, framework, extensible |

## Links

- npm: https://www.npmjs.com/package/exseed
- Repository: https://github.com/exseed/exseed
- Issues: https://github.com/exseed/exseed/issues
- npm.io page: https://npm.io/package/exseed

## Dependencies (6)

- [async](https://npm.io/package/async.md) ^1.5.2
- [react](https://npm.io/package/react.md) ^0.14.2
- [express](https://npm.io/package/express.md) ^4.13.3
- [react-dom](https://npm.io/package/react-dom.md) ^0.14.2
- [waterline](https://npm.io/package/waterline.md) ^0.10.26
- [sails-memory](https://npm.io/package/sails-memory.md) ^0.10.5

## Alternatives

- [@sveltejs/kit](https://npm.io/package/@sveltejs/kit.md) — 2.2M weekly downloads
- [@tangle-network/brand](https://npm.io/package/@tangle-network/brand.md) — 10.0K weekly downloads
- [seneca](https://npm.io/package/seneca.md) — 7.4K weekly downloads
- [@bsb/base](https://npm.io/package/@bsb/base.md) — 7.2K weekly downloads
- [@modern-js/plugin-swc](https://npm.io/package/@modern-js/plugin-swc.md) — 3.4K weekly downloads

## Recent versions

- 0.2.2 (latest) — 2016-02-16
- 0.2.1 — 2016-02-16
- 0.2.0 — 2016-02-16
- 0.1.15 — 2016-01-05
- 0.1.14 — 2015-12-03
- 0.1.13 — 2015-12-02
- 0.1.12 — 2015-12-02
- 0.1.11 — 2015-12-02
- 0.1.10 — 2015-12-02
- 0.1.9 — 2015-12-02
- 0.1.8 — 2015-12-02
- 0.1.7 — 2015-12-02
- 0.1.6 — 2015-12-02
- 0.1.5 — 2015-12-02
- 0.1.4 — 2015-12-02
- … 2 more at https://npm.io/package/exseed/versions

## README

# Exseed

[![Build Status](https://travis-ci.org/exseed/exseed.svg?branch=master)](https://travis-ci.org/exseed/exseed)
[![npm version](https://badge.fury.io/js/exseed.svg)](https://badge.fury.io/js/exseed)
[![Code Climate](https://codeclimate.com/github/exseed/exseed/badges/gpa.svg)](https://codeclimate.com/github/exseed/exseed)
[![Dependency Status](https://david-dm.org/exseed/exseed.svg)](https://david-dm.org/exseed/exseed)

A highly extensible nodejs framework

## Features

- Highly Extensible
- Easy to Use
- Full Stack
- ORM Integrated
- ES6/ES7 Syntax
- Isomorphic

## Workflow & Implementation Details

| Item       | Choice |
|------------|--------|
| Build Tool | [Webpack](https://github.com/webpack/webpack) |
| Automation | [Gulp](https://github.com/gulpjs/gulp) |
| Backend    | [Node](https://nodejs.org/en/), [Express(>=4.0.0)](http://expressjs.com/) |
| ORM        | [Waterline](https://github.com/balderdashy/waterline) |
| Frontend   | [React](https://facebook.github.io/react/), [Redux](https://github.com/rackt/redux)/[Alt](http://alt.js.org/), [React-Router](https://github.com/rackt/react-router) |
| Testing    | [Mocha](https://mochajs.org/) |
| CI         | [Travis CI](https://travis-ci.org/) |

## Compare to Other Frameworks

|               | Exseed   | Express | Koa    | Sails  | Hapi   |
| ------------- | ------ | ------- | ------ | ------ | ------ |
| Extensibility | ★★★★★ | ★★★★★ | ★★★★☆ | ★★★★☆ | ★★★★☆ |
| Threshold     | ★★★☆☆ | ★★☆☆☆ | ★★★☆☆ | ★★★★☆ | ★★☆☆☆ |
| Build Speed   | ★★★★★ | ★☆☆☆☆ | ★☆☆☆☆ | ★★★★☆ | ★☆☆☆☆ |
| Full Stack    | ✔      |         |        | ✔      |        |
| ORM           | ✔      |         |        | ✔      |        |
| Modern Syntax | ✔      |         | ✔      |        |        |
| Isomorphic    | ✔      |         |        |        |        |

## Usage

1. Install CLI

  ```
  $ npm install -g exseed-cli
  ```

2. Clone the [boilerplate project](https://github.com/exseed/exseed-boilerplate)

3. Install dependencies

  ```
  $ cd exseed-boilerplate
  $ npm install
  ```

4. Run it

  ```
  $ sd build --watch
  $ sd init
  $ sd serve
  ```

## Example - Todo List

1. File Structure

  ```
  - <project root>
  ----- settings.js
  ----- exseed.core/
  ----- todoapp/
  --------- settings.js
  --------- models.js
  --------- routes.js
  --------- flux/
  ------------- boot.js
  ------------- routes.js
  ------------- views/pages/MainPage.js
  ----- <other_app_1>/
  ----- <other_app_2>/
  ----- <other_app_n>/
  ```

2. Update installed apps

  Tell exseed what apps you want to use

  ```js
  // settings.js

  export default {
    installedApps: [
      './exseed.core',
      // other apps
      './todoapp',
    ],
    // other settings
  };
  ```

3. The server side

  ```js
  // todoapp/settings.js

  export default {
    name: 'todo',
  };
  ```

  ```js
  // todoapp/models.js

  export const todolist = {
    identity: 'todolist',
    attributes: {
      content: {
        type: 'string',
        required: true,
      },
    },
  };
  ```

  ```js
  // todoapp/routes.js
  
  import { models } from 'exseed';

  export default function routes({ app }) {
    app.get('/api/todolist', (req, res) => {
      models.todolist
        .find()
        .then((todolist) => {
          res.json(todolist);
        });
    });

    app.post('/api/todolist', (req, res) => {
      models.todolist
        .create(req.body.todo)
        .then((todo) => {
          res.json(todo);
        });
    });
  }
  ```

4. The client side

  All react related files are inside `todoapp/flux` folder

  ```js
  // todoapp/flux/boot.js

  import React from 'react';
  import { render } from 'react-dom';
  import { Router, browserHistory } from 'react-router';
  import routes from './routes';

  render(
    <Router history={browserHistory}>
      {routes}
    </Router>
  , document.getElementById('exseed_root'));
  ```

  ```js
  // todoapp/flux/routes.js

  import React from 'react';
  import { Route, IndexRoute } from 'react-router';

  import settings from '../settings';
  import MainPage from './views/pages/MainPage';

  export default (
    <Route path="/todo" component={MainPage} EXSEED_APP_NAME={settings.name} />
  );
  ```

  ```js
  // todoapp/flux/views/pages/MainPage.js

  import React from 'react';
  import BaseLayout
  from '../../../../exseed.core/flux/views/layouts/BaseLayout';

  export default class MainPage extends React.Component {
    ...

    render() {
      const scripts = [
        'https://cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.min.js',
        '/todo/js/bundle.js',
      ];

      return (
        <BaseLayout
          title="Exseed - Todo"
          scripts={scripts}>
          <h1>Todo</h1>
          <input
            type="text"
            onKeyDown={this.handleKeyDown.bind(this)}
            onChange={this.handleChange.bind(this)}
            value={this.state.content} />
          <ul>
            {this.state.todos.map(todo => (
              <li key={todo.id}>
                {todo.content}
              </li>
            ))}
          </ul>
        </BaseLayout>
      );
    }
  };
  ```

See the complete [todo app](https://github.com/exseed/exseed-boilerplate/tree/master/src/todoapp)

## Docs

- [API Docs](http://exseed.github.io/docs/exseed/0.1.15)
- [Developer Guide](https://github.com/exseed/exseed/blob/master/docs%2Fdeveloper%20guide.md)

---
_Source: https://npm.io/package/exseed · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
