# Creating a new App
## Install Frappe.js
```
yarn add frappejs
```
FrappeJS comes with an Express Server on the backend, VueJS for the front-end and a CLI to run these things with built-in webpack configs.
## Config
FrappeJS requires a file named `frappe.conf.js` to be present in the root of your directory. Minimum configuration looks like:
```
module.exports = {
staticPath: './static', // uploaded files are served from this directory
distPath: './dist', // bundled assets are built and served here
dev: {
// your client side entry files
entry: {
app: './src/main.js'
},
outputDir: './dist',
assetsPublicPath: '/',
devServerPort: 8000,
env: {
PORT: process.env.PORT || 8000
}
},
node: {
paths: {
main: 'server/index.js' // your server entry file
}
},
electron: {
// wip
}
}
```
You also need an `index.html` located in the `src` directory. It can look like
```html
My Awesome App
```
### Server
Assuming you have a `server/index.js` file, you can start the frappejs server in just a few lines of code.
```js
const server = require('frappejs/server');
server.start({
backend: 'sqlite',
connection_params: {
db_path: 'test.db'
}
});
```
### Client
In your client file you will have to initialize `frappe` and `models`.
`frappejs/client` lib will initialize your server and user interface with the Desk.
Example starting point for an app:
```js
import frappe from 'frappejs';
import io from 'socket.io-client';
import HTTPClient from 'frappejs/backends/http';
import common from 'frappejs/common';
import coreModels from 'frappejs/models';
frappe.init();
frappe.registerLibs(common);
frappe.registerModels(coreModels);
const server = 'localhost:8000';
frappe.fetch = window.fetch.bind();
frappe.db = new HTTPClient({ server });
const socket = io.connect(`http://${server}`);
frappe.db.bindSocketClient(socket);
```
## Start
To start the server and build webpack simultaneously you can use the cli command
```bash
./node_modules/.bin/frappe start
```