protevus/README.md

# ORM Starter Application for Angel3 framework

This is an ORM starter application for [Angel3 framework](https://angel3-framework.web.app) which is a full-stack Web framework in Dart. The default database is `postgresql`. `mysql` support is still in active development.

## Installation & Setup

1. Download and install [Dart](https://dart.dev/get-dart).
2. Install `postgresql` version 10, 11, 12 and 13
3. Create a new user and database in postgres using `psql` cli. For example:

   ```sql
    postgres=# create database appdb;
    postgres=# create user appuser with encrypted password 'App1970#';
    postgres=# grant all privileges on database appdb to appuser;
   ```

4. Update the `postgres` section in the `config/default.yaml` file with the newly created user and database name.

   ```yaml
    postgres:
        host: localhost
        port: 5432
        database_name: appdb
        username: appuser
        password: App1970#
        useSSL: false
        time_zone: UTC
   ```

5. Run the migration to generate `migrations` and `greetings` tables in the database.

    ```bash
    dart bin/migrate.dart up
    ```

### Development

1. Run the following command to start Angel3 server in dev mode to *hot-reloaded* on file changes:

    ```bash
    dart --observe bin/dev.dart
    ```

2. Modify the code and watch the changes applied to the application

3. Insert a message into DB:

    ```bash
    curl -H "Content-Type: application/json" -X POST -d '{"message":"OK_Message" }' "http://localhost:3000/greetings/"
    ```

    or

    ```bash
    curl -X POST -d 'message=OK_Message2' "http://localhost:3000/greetings/"
    ```

4. Query DB:

    ```
    http://localhost:3000/greetings/
    ```

### Production

1. Run the following command:

    ```bash
    dart bin/prod.dart
    ```

2. Run as docker. Edit and run the provided `Dockerfile` to build the image.

## Resources

Visit the [Developer Guide](https://angel3-docs.dukefirehawk.com/guides) for dozens of guides and resources, including video tutorials, to get up and running as quickly as possible with Angel3.

Examples and complete projects can be found [here](https://angel3-framework.web.app/#/examples).

You can also view the [API Documentation](https://pub.dev/documentation/angel3_framework/latest/).