GitHub package.json version GitHub package.json license Mocha tests ok

Main logo

appalti190-server is an open‑source server side project for a general-purpose web app implementing a generic SAAS.

Appalti190-server ...

Tests Coverage

Mocha unit+e2e tests coverage

Features

Appalti190-server provides the following features:

  • Production-ready APIs
  • Data Model
  • Role Based Access Control (RBAC)
  • Microservices Support
  • Continuous GitHub Sync
  • TypeScript and Node.js Source Code
  • Plugin System
  • Monorepo or Polyrepo
  • Custom Code
  • Admin UI
  • Appalti190-server Console & CLI

Getting Started

You can get started with Appalti190-server immediately on the Appalti190-server Cloud.

Alternatively you can set up a local development environment.

See the Appalti190-server Website or Appalti190-server Docs for more details.

Tutorials

Appalti190-server Cloud (SaaS)

Launch Appalti190-server from app.Appalti190-server.com

Development Environment (Local)

System Requirements

💡 Before you begin, make sure you have the following installed:

Getting Started With Local Development

Appalti190-server is using a monorepo (powered by Nx Workspaces) with multiple apps and libraries.

Follow these simple instructions to set up a local development environment.

  1. Clone the repository and install dependencies:
git clone https://github.com/marcolino/appalti190-server.git
cd appalti190-server
npm install
  1. Run the setup script, which takes care of installing dependencies, building packages and ensuring your workspace is dev-ready.
npm run setup:dev
  1. Spin up all required infrastructure (Postgres, Kafka, etc.) using Docker Compose:
# To be able to view logs
npm run docker:dev

# Or, if you prefer to run it at the background
npm run docker:dev -- -d
  1. Apply database migrations:
npm run db:migrate:deploy
  1. To start developing, run the serve target of the desired app:
# This will serve the Appalti190-server Server in development mode
npx nx serve Appalti190-server-server

# This will serve the Appalti190-server Client in development mode
npx nx serve Appalti190-server-client
  • Please note that in order to be able to run the app's client properly, you need to serve both the server and client.

That's it, you are good to go! Happy hacking! 👾

You can always find more information in each app/library's respective README.md file.

Setting Up Appalti190-server Manually

You can use a manual step-by-step approach to set up Appalti190-server in a local development environment. To do so, you should follow the following instructions for Setting Up Appalti190-server Server, and Setting Up Appalti190-server Client.

Setting up Appalti190-server Server

Appalti190-server Server is the main component of the platform that provides all the core functionality to design and create low-code applications. The server exposes a GraphQL API for all actions. The server is built with the following awesome open-source technologies: Node.js, NestJS, Prisma over PostgreSQL, GraphQL API, and many more...

Setting Up Appalti190-server Client

Appalti190-server Client is the front end of the platform that provides you with an easy-to-drive UI for building your next low-code application. The client is based on React, Apollo client, Primer components, React Material Web Components, Formik, and more.

Version 1

Appalti190-server is currently in version 1. This is the first major release of Appalti190-server with enterprise-grade production readiness & scale. In this version, we have introduced multiple new features and enhanced the existing ones. The feature set is listed above in the Features section.

Support

Ask your questions and participate in discussions regarding Appalti190-server-related and web-dev topics at the Appalti190-server Discord server.

Create a Bug Report

If you see an error message or run into an issue, please create bug report. This effort is valued and helps all Appalti190-server users.

Submit a Feature Request

If you have an idea, or you're missing a capability that would make development easier and more robust, please Submit feature request.

If a similar feature request already exists, don't forget to leave a "+1". If you add some more information such as your thoughts and vision about the feature, your comments will be embraced warmly :)

Contributing

Appalti190-server is an open-source project. We are committed to a fully transparent development process and highly appreciate any contributions. Whether you are helping us fix bugs, proposing new features, improving our documentation or spreading the word - we would love to have you as a part of the Appalti190-server community.

Useful Links

Please refer to our Contribution Guidelines and Code of Conduct.

Contributors ✨

Thanks goes to these wonderful people (🤗):

Marco Solari
Marco Solari

💻

This project follows the all-contributors specification. Contributions of any kind welcome!