Skip to content
master
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

appy logo

vue license GitHub release

appy is a full featured boilerplate web app designed as an end to end solution for mvp development. The frontend is built on Vue.js and utilizes the AdminLTE UI template. The backend implements a hapi server (via rest-hapi) with a MongoDB datastore.

appy-dashboard

Just want an API server? Try appy-backend

Live Demo: https://appyapp.io/#live_demo


appy is being sponsored by the following tool; please help to support us by taking a look and signing up to a free trial!

GitAds

Requirements

Just Docker

OR

You need Node.js installed (>=12.14.1) and you'll need MongoDB installed and running.

Getting Started

Download from GitHub:

$ git clone https://github.com/JKHeadley/appy.git
$ cd appy

Using Docker

NOTE: Docker commands might take some time on the first build. After the first build they should be relatively quick.

Rename backend/.env-docker-sample to backend/.env-docker and update any secrets or keys as needed (this is not required, but at minimum providing a valid IPSTACK_ACCESS_KEY will allow for proper dashboard data). Never commit .env-docker to your repo

Also, update values in backend/config/index.js as needed.

Seed the db with data (only required once):

$ sh seed_data.sh

Once seeding is done, run the app:

$ sh run_app.sh

Point your browser to http://localhost:3000/ to view the app, http://localhost:8080/ to view the swagger API docs, or click on one of the test accounts below to login:

NOTE: Password for all seed users is root.

User

Admin

Super Admin

...that's it, have fun!

Without Docker

Install dependencies:

Backend

$ cd backend
$ npm install

Frontend

$ cd frontend
$ npm install

Backend Configuration

Rename .env-sample to .env and update any secrets or keys as needed (this is not required, but at minimum providing a valid IPSTACK_ACCESS_KEY will allow for proper dashboard data). Never commit .env to your repo

Also, update values in backend/config/index.js as needed.

First time setup

WARNING: This will clear all data in the MongoDB database defined in restHapiConfig.mongo.URI (default mongodb://localhost/appy).

To seed your database with some data, run:

$ npm run seed

NOTE: The password for all seed users is root.

Running appy

Backend

$ npm run start

Point your browser to http://localhost:8080/ to view the Swagger docs.

Frontend

$ npm run start

Point your browser to http://localhost:3000/ to view the app, or click on one of the test accounts below to login:

User

Admin

Super Admin

Temporary Docs

Official docs for appy are coming soon, but for now you can find some information in the appy-backend wiki

License

appy is an open source project by Justin Headley that is licensed under MIT.

This project is undergoing a major update. Complete README and docs coming soon.

You can’t perform that action at this time.