Webapp that allows users to create libraries, share details, and create reviews on books they've read. Written using the Amber Crystal Framework

New Reads

Amber Framework


This project is archived, please refer to the GitLab repository for the most up-to-date version.


This is a webapp written in Crystal and powered by the Amber Framework. This webapp acts as a library where users store their books and can write notes + reviews about said books.

Getting Started

These instructions will get a copy of this project running on your machine for development and testing purposes.

Please see deployment for notes on deploying the project in production.


This project requires Crystal (installation guide).


To start your Amber server:

  1. Install dependencies with shards install
  2. Build executables with shards build
  3. Create and migrate your database with bin/amber db create migrate. Also see creating the database.
  4. Start Amber server with bin/amber watch

Now you can visit http://localhost:3000/ from your browser.

Getting an error message you need help decoding? Check the Amber troubleshooting guide, post a tagged message on Stack Overflow, or visit Amber on Gitter.

Using Docker? Please check Amber Docker guides.


To run the test suite:

crystal spec


  1. Fork it ( )
  2. Create your feature branch ( git checkout -b my-new-feature )
  3. Commit your changes ( git commit -am 'Add some feature' )
  4. Push to the branch ( git push origin my-new-feature )
  5. Create a new Pull Request



  • Add more validation routes like /book/new
  • Add roles to users via a roles table and foreign key assignment
  • Further integrate relation of books to users and so forth
github statistic
  • 0
  • 0
  • 0
  • 1
  • 4 months ago
  • March 5, 2020

Synced at

Thu, 29 Oct 2020 08:45:52 GMT