Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/genez-io/genezio
Deploy on the fastest full-stack cloud. Experience the autoscaling of near-zero latency serverless without rewriting your code.
https://github.com/genez-io/genezio
angular backend dart flutter frontend javascript open-source react serverless serverless-functions swift typescript vue
Last synced: 3 days ago
JSON representation
Deploy on the fastest full-stack cloud. Experience the autoscaling of near-zero latency serverless without rewriting your code.
- Host: GitHub
- URL: https://github.com/genez-io/genezio
- Owner: Genez-io
- License: gpl-3.0
- Created: 2022-10-04T07:52:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-10T21:23:27.000Z (11 days ago)
- Last Synced: 2025-01-11T19:01:07.626Z (10 days ago)
- Topics: angular, backend, dart, flutter, frontend, javascript, open-source, react, serverless, serverless-functions, swift, typescript, vue
- Language: TypeScript
- Homepage: https://genezio.com
- Size: 20.3 MB
- Stars: 481
- Watchers: 8
- Forks: 10
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://github.com/Genez-io/genezio/actions/workflows/unit-test.yaml)
[](https://github.com/Genez-io/genezio-tests/actions/workflows/integration-prod-windows.yml)
[](https://github.com/Genez-io/genezio-tests/actions/workflows/integration-prod-linux.yml)
[](https://www.npmjs.com/package/genezio)
[](https://www.npmjs.com/package/genezio)
[](https://github.com/Genez-io/genezio/blob/main/CONTRIBUTING.md)
[](https://discord.gg/uc9H5YKjXv)
[](https://twitter.com/geneziodev)
# What is [Genezio](https://genezio.com)?
[Genezio](https://genezio.com/) is a developer platform for full-stack developers or teams who need to build, run and maintain web, mobile or enterprise apps with a typesafe backend that scales automatically.
For more details on how to use `genezio`, you can check out the official [documentation](https://genezio.com/docs).
:star: If you want to support the genezio community, give us a star on this repo :star:
# Contents
- [Features](#features)
- [Getting Started](#getting-started)
- [Installation](#installation)
- [Create a new project](#create-a-new-project)
- [Test your project using the Test Interface](#test-your-project-using-the-test-interface)
- [Commands Summary](#commands-summary)
- [Examples deployed with genezio](#examples-deployed-with-genezio)
- [Official documentation](#official-documentation)
- [How does genezio work?](#how-does-`genezio`-work?)
- [Detailed documentation](#detailed-documentation)
- [Getting support](#getting-support)
- [System requirements](#system-requirements)
- [Troubleshooting](#troubleshooting)
- [Contributing](#contributing)
- [Ecosystem](#ecosystem)
- [Tutorials](#tutorials)
- [Badge](#badge)
- [License](#license)
# Features
- 🚀 **Function-as-a-service**: No need to worry about infrastructure, scaling, or maintenance.
- 📦 **Genezio Functions**: Deploy and run code on-demand without managing servers or infrastructure.
- 🚀 **Programming Languages**: Tested and production ready for Javascript/Typescript and Python.
- 🌐 **Framework agnostic**: works with React, Vue, Angular, Flutter, Svelte, Next, Nuxt, Nest.
- 🎯 **Seamless Bundling and Compiling**: automatically bundles and compiles your code, including dependencies, for efficient and error-free deployment.
- ⚡ **Deploy with one command** the backend and the frontend.
- 🧩 **Typesafe RPC**: Ensuring type safety and IDE auto-completion across diverse languages like TypeScript, Flutter (Dart), Kotlin and Go, by leveraging advanced code analysis.
- 📦 **NPM Registry**: the client SDK is pushed to a private or public registry.
- 🔄 **Multiple staging environments** supported as well as local development environment.
- 🖥️ **Dashboard**: explore logs, env variables for different environments, [Test interface](https://github.com/Genez-io/genezio?tab=readme-ov-file#test-your-project-using-the-test-interface) and easy to access third party integration.
- 👥 **Collaboration**: work alone or as a team - share the projects and dashboard features between team members with different access rights.
- ➰ **Queues**: use them for your automation apps.
- 🗄 **Databases**: provisioned by us or you can bring your own. The database is not exposed to the frontend directly. Table creation and CRUD boilerplate functions generated through LLM.
- 🕒 **Cron jobs**: scheduled to be executed up to a minute granularity.
# Getting Started
Check out our [Getting started](https://genezio.com/docs/getting-started) documentation page to find out how to start using Genezio.
For more details about the `genezio` CLI commands, run `genezio help` or `genezio [command] help`.
# Installation
To install the `genezio` CLI tool, run the following command:
```bash
npm install -g genezio
```
# Create a new project
Visit the [Genezio template page](https://app.genez.io/new-project) and create a new project. You can choose from a variety of templates or start from scratch.
If you want to create a new project from scratch, you can run the following command:
```bash
genezio create
```
If you already have a project you can either [import it from you GitHub repository](https://app.genez.io/import) or deploy it from your local machine using the following command:
```bash
genezio deploy
```
# Test your project using the Test Interface
You can also test your code locally by running the following command in the `server` directory.
```bash
genezio local
```
This will spawn a local server that can be used for testing.
Now, you can navigate to the [Test Interface](https://app.genez.io/test-interface/local?port=8083) and test your project locally from GUI.
Once you are happy with your project, you can deploy it in a production environment by running: `genezio deploy`.
# Commands Summary
The genezio CLI tool supports the commands shown in the following table:
| Command | Description |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| genezio create | Create a new fullstack project from templates [Learn more](https://genezio.com/docs/cli-tool/cli-commands/genezio-create) |
| genezio local --port `` | Runs a local environment with your project for testing purposes. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/local) |
| genezio deploy | Deploys your project to the genezio infrastructure. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/deploy) |
| genezio list `[]` | Displays details of your projects. You can view them all at once or display a particular one by providing its name or ID. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/ls) |
| genezio delete `[]` | Deletes the project described by the provided ID. If no ID is provided, lists all the projects and IDs. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/delete) |
| genezio sdk | Generates an SDK corresponding to a deployed project. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/generatesdk) |
| genezio account | Display information about the current account logged in. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/account) |
| genezio login `` | Authenticates with genezio platform to deploy your code. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/login) |
| genezio logout | Logout from genezio platform. [Learn more](https://genezio.com/docs/cli-tool/cli-commands/logout) |
| genezio help / genezio `` --help | Displays help for the CLI tool. |
# Examples deployed with genezio
You can find out more about `genezio` from our [examples repository](https://github.com/Genez-io/genezio-examples).
# Official documentation
## How does genezio work?
`genezio` is using JSON RPC 2.0 to facilitate the communication between SDK and your class. Your functions are deployed in the Genezio infrastructure. The functions are not executed on a long lasting Virtual Machine. Instead, our system uses a serverless approach. Whenever a request is received, your code is loaded and executed. This is more cost and energy efficient. However, the developer needs to take into account the following - the values of the global variables are not persistent between runs.
Type safety is ensured by the generated SDK, even if the server and the client are not written in the same language. The CLI tool analyzes the server code generates client side types equivalent to the server side types, as well as functions with equivalent signatures.
## Detailed documentation
To find more details on how to use `genezio`, check out the official [documentation](https://genezio.com/docs):
- [Getting started](https://genezio.com/docs/getting-started)
- [Project Structure](https://genezio.com/docs/project-structure)
- [CLI commands](https://genezio.com/docs/cli-tool)
- [Test Interface](https://genezio.com/docs/test-interface)
- [Integrations](https://genezio.com/docs/integrations)
If you cannot find what you are looking for in the docs, don't hesitate to drop us a [GitHub issue](https://github.com/Genez-io/genezio/issues) or [start a discussion on Discord](https://discord.gg/uc9H5YKjXv).
# Getting support
We want you to get your project up and running in no-time.
If you find yourself in a pickle using `genezio`, drop us a [GitHub issue](https://github.com/Genez-io/genezio/issues), [start a discussion with us on Discord](https://discord.gg/uc9H5YKjXv) or drop us an email at [[email protected]]([email protected]).
# System requirements
- `genezio` can be installed and used on macOS, Linux-based distributions and Windows.
- A version of `node` >= 18 should be installed on your machine.
# Troubleshooting
For the most common issues that our users have dealt with, we created a [Troubleshooting](https://genezio.com/docs/troubleshooting) section in the documentation.
If you don't find the guidance there, drop us a [GitHub issue](https://github.com/Genez-io/genezio/issues). We are more than happy to help you!
# Contributing
Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for more details.
Show your support by giving us a star :star:, to help others discover `genezio` and become part of our community!
# Ecosystem
There are a growing number of awesome projects deployed with `genezio` and we want to shout out about them.
If you deployed a project using `genezio` let us know on [Discord](https://discord.gg/uc9H5YKjXv).
# Tutorials
Check out [tutorials for building and deploying](https://genezio.com/tags/tutorials/) various use cases with Genezio.
# Badge
Brag to your friends that you are using `genezio` with this awesome badge -> [](https://github.com/genez-io/genezio)
```md
[](https://github.com/genez-io/genezio)
```
# License
`genezio` is licensed under `GNU General Public License v3.0`. For more information, please refer to [LICENSE](LICENSE).