An open API service indexing awesome lists of open source software.

https://github.com/socketcluster/ag-crud-sample

Sample real-time CRUD inventory tracking app built with Asyngular
https://github.com/socketcluster/ag-crud-sample

Last synced: about 1 year ago
JSON representation

Sample real-time CRUD inventory tracking app built with Asyngular

Awesome Lists containing this project

README

          

# ag-crud-sample

Scroll to the bottom for installation instructions.

A sample inventory tracking realtime single page app built with SocketCluster (https://socketcluster.io/), VueJS and RethinkDB.
It demonstrates a way of building realtime apps.

All code for the server-side worker logic is linked from worker.js - It's mostly generic so feel free to reuse/modify for your own app
or you can use this app as a base to build yours if starting from scratch.

Aside from SocketCluster, VueJS and RethinkDB, this sample app uses the following modules:
- ag-collection (https://github.com/SocketCluster/ag-collection - ```npm install ag-collection```)
- ag-model (https://github.com/SocketCluster/ag-model - ```npm install ag-model```)
- ag-crud-rethink (https://github.com/SocketCluster/ag-crud-rethink - ```npm install ag-crud-rethink```)

This sample app aims to demonstrate all the cutting edge features that one might want when
building a realtime single page app including:

- Authentication (via JWT tokens)
- Access control using backend middleware
- Reactive data binding
- Realtime REST-like interface
- Pagination with realtime updates

Keep in mind that this app is optimized for cutting-edgeness, not for backwards
compatibility with older browsers.

To make the most of this demo, you should open the web app in two different tabs/windows/browsers and
make updates to the data in realtime.

## Installation

To setup and run this sample:

- Make sure you have Git installed (https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- Make sure you have Node.js installed (http://nodejs.org/)
- Make sure you have RethinkDB installed (https://www.rethinkdb.com/)
- Run ```git clone https://github.com/SocketCluster/ag-crud-sample.git```
- Run ```cd ag-crud-sample``` (to navigate to the ag-crud-sample/ directory)
- Run ```npm install``` (to install back end modules)
- Run ```cd public && npm install && cd ..``` (to install front end modules inside the public/ directory)
- In a different terminal (or in the background), run ```sudo rethinkdb``` (make sure RethinkDB stays running)
- Run ```node server``` (to launch the server)
- In your browser, go to ```http://localhost:8000/```