angarsk8/realtime-todo-app

Realtime Todo application developed with Kemal, React, ES2015 and PostgreSQL

Todo Basic App (Crystal - Kemal - WebSockets - React - PostgreSQL - Docker)

Requirements

• Crystal 0.18.7
• PostgreSQL (v9.5.2)
• Node (v5.11.1)
• NPM (v3.8.6)
• Docker (v1.12.1) && Docker-Compose (v1.8.0)

^{*Node and NPM are both optional if you are just going to run the app, but necessary for development since they are needed to run webpack}

Manual Installation

Before you can run this program you have to install the packages that it uses. You do that with $ shards install . You also need to configure the path to the PostgreSQL database in the files src/db/init_db.cr and src/app.cr

# src/db/init_db.cr
require "pg"

# Configure these two variables
DB_NAME = "db_name"
PG_PATH = "postgres://user:password@localhost:5432"

...

# src/app.cr
require "kemal"
require "pg"

require "./app/models/*"

public_folder "src/public"

# Configure the path of the database based on what you did in the src/db/init_db.cr file
DB_PATH = "postgres://user:password@localhost:5432"
...

Once you have installed the dependencies and configured the database path, you need to create the actual database and table for the application. You do that by running $ crystal src/db/init_db.cr.

Run Project

You can run this program in two ways:

1. Compile/build the project using the command line with $ crystal build src/notes.cr --release and run the executable $ ./notes
2. Run the program with $ crystal src/notes.cr (no compilation required)

Once you have run the program, you can open a browser window at localthost:3000 and see the actual app. You can open the app in several browser windows and see how they change in real time via websockets. In the first option you can also pass the port number as an argument to the program, like this ./notes --port <port-number> and the program will show at http://<server-ip-number>:<port-number>.

Installation With Docker

You nee to run one single command: docker-compose up or docker-compose up -d.

Live Demo

You can see and use a live demo of the app here: kemal-ws-react-pg-todo.herokuapp.com.

^{*Take in mind that this is just a dummy app written in few hours as a proof of concept.}

Development

• $ npm install
• $ npm run dev && crystal src/notes.cr

realtime-todo-app's Issues

error Note.all, self.transform_notes(conn.exec{%{ ), undefined method 'to_hash'

hey as i try to compile i got those errors ,can you please help me to solve them ?

andre@DESKTOP-VH5PTMF:/mnt/c/Users/andre/cr/space$ crystal run src/index.cr --error-trace
Error in src/index.cr:16: instantiating 'Note:Class#all(DB::Database)'

socket.send Note.all(conn).to_json
^~~

in src/models/note.cr:12: instantiating 'Note:Class#transform_notes(DB::ExecResult)'

    self.transform_notes(conn.exec(%{
         ^~~~~~~~~~~~~~~

in src/models/note.cr:52: undefined method 'to_hash' for DB::ExecResult

    notes.to_hash.map do |note|
          ^~~~~~~

================================================================================

DB::ExecResult trace:

src/models/note.cr:51

      def self.transform_notes(notes)

Change repo's 'crystal-language' topic to 'crystal'

The Crystal community has somewhat decided to use crystal as the language's topic.

To avoid fragmentation in the community, please change the crystal-language topic, that only has ~28 repositories at the moment, to crystal.

Any contributor can change it from the repo's homepage.

See crystal-lang/crystal#4241 for more context.

Thank you very much :)