Overview

ROQ One is an open source kickstarter application that can be used as a starting point for any web application. It’s pre-integrated with all features of ROQ Platform and it ships with a powerful code generator. Using ROQ One is a huge time saver, still using it is entirely optional in case you want to develop your own backend application.

ROQ One repository

🛠 github.com/roqtech/roq-one

Local installation

Local installation guide

License

MIT

ROQ One consists of two applications: 

  • ROQ One Frontend: A client-side application that represents the responsive user interface.

  • ROQ One Backend: A server-side application that holds the API, business logic and persistence layer.

ROQ One Frontend

ROQ One Frontend is a fully functional and customizable open source frontend service based on React and Next.js. Beside its beautiful and highly customizable user interface it provides ootb capabilities like authentication, single-sign-on, night-mode and a responsive layout and all the features of ROQ Platform (see Feature overview )

You can find the full list of technologies here: Technologies used (frontend)

ROQ One Backend

ROQ One Backend is based on the modular framework Nest.js, Apollo Server and TypeORM. Again the programming language is Typescript and the underlying database is Postgres. ROQ One Backend is using GraphQL as the main approach to represent its API. If required REST can be used as well. A full list of technologies is available here: Technologies used (backend)

Out-of-the-box capabilities

ROQ One is designed like a framework and it’s equipped with all the default capabilities that are needed for any project:

Architecture

Having a well-crafted architecture in place from day 1 is a main advantage and will boost the productivity of the team

Authentication

Based on protected JWT tokens.

User interface

ROQ One Frontend ships with a ready-to-use user interface that can be either adopted or replaced. The user interface is responsive and also has a dark mode.

Data table

ROQ One Frontend contains a fully working data table solution

Data seeding

ROQ One Backend ships with a mechanism that allows to populate the database seed and demo data

Logging

ROQ One creates logs on every request. The logger is fully functional and logs can be sent to any engine (like GCP logs or Logstash/Kibana)

Monitoring

Monitoring can happen either on the infrastructure level (e.g. within GCP, AWS or Azure). Engineers often need to get more insights from the running application that’s why ROQ One is integrated with an external APM (application monitoring system) New Relic.

Local development

ROQ One ships with a docker-compose file that is used to build the local development environment in seconds

Integration with ROQ Platform

ROQ One is pre-integrated with ROQ Platform via GraphQL. ROQ Platform provides multiple additional features like a chat system, notifications and mails.