Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/avitorio/quickstack

QuickStack - NestJS + Expo Boilerplate for Fast Web and Mobile App Development.
https://github.com/avitorio/quickstack

docker expo graphql nestjs typescript

Last synced: about 1 month ago
JSON representation

QuickStack - NestJS + Expo Boilerplate for Fast Web and Mobile App Development.

Awesome Lists containing this project

README

        


QuickStack


QuickStack - NestJS + Expo Boilerplate for Fast Web and Mobile App Development.


PRs welcome!
License


Follow @andrevitorio


Features β€’
Getting started β€’
Contributing β€’
License

## πŸš€ Features

- NestJS;
- Expo;
- Typescript;
- GraphQL;
- PostgresSQL;
- React Native Paper;
- Handlebars for Email Templates;
- Docker;
- Authentication;
- User Registration;
- User Roles;
- Password Recovery;
- Backend Tests;

## ⚑️ Getting started

### Backend

Clone the repository and in your terminal cd into /backend.

Using Yarn:

```sh
yarn
```

Using NPM:

```sh
npm install
```

Make duplicates of the .example files in the root and /config directories and remove the .example extension.
Edit them with your credentials.

If you'd like to load the backend with Docker, run:

```sh
docker-compose up
```

Otherwise, if you have a Postgres instance running, you can run:

```sh
yarn start:dev
```

or

```sh
npm run start:dev
```

### Frontend

cd into /frontend.

Using Yarn:

```sh
yarn
```

Using NPM:

```sh
npm install
```

Once the installation is done, run:

```sh
expo start
```

## πŸ‘©πŸ½β€πŸ’» User Roles

The boilerplate currently comes with two roles, Admins and Members.
The role of Admin is assigned to the first user to register on the system.
Subsequent users are registered as members.
There's a role guard setup on the backend for GraphQL endpoints and on the frontend
for routes. I'll be updating the Users list screen so that Admins can update users
information from the Dashboard.

## ✨ Contributing

Thanks for being interested in contributing! We’re so glad you want to help! All type of contributions are welcome, such as bug fixes, issues or feature requests.

## πŸ“ License

Licensed under the [MIT License](./LICENSE).