{"id":13548595,"url":"https://github.com/celest-dev/celest","last_synced_at":"2025-04-09T12:07:09.866Z","repository":{"id":211512080,"uuid":"718343701","full_name":"celest-dev/celest","owner":"celest-dev","description":"The Flutter cloud platform","archived":false,"fork":false,"pushed_at":"2024-04-23T14:42:36.000Z","size":1922,"stargazers_count":203,"open_issues_count":19,"forks_count":11,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-04-25T10:20:28.361Z","etag":null,"topics":["backend","cloud","dart","flutter","serverless"],"latest_commit_sha":null,"homepage":"https://celest.dev","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/celest-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-13T22:17:01.000Z","updated_at":"2024-04-29T22:49:58.163Z","dependencies_parsed_at":"2024-02-11T00:24:47.528Z","dependency_job_id":"5ed2fddd-3efc-4243-b366-b78735a4a6e4","html_url":"https://github.com/celest-dev/celest","commit_stats":null,"previous_names":["celest-dev/celest"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celest-dev%2Fcelest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celest-dev%2Fcelest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celest-dev%2Fcelest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celest-dev%2Fcelest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/celest-dev","download_url":"https://codeload.github.com/celest-dev/celest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248036063,"owners_count":21037092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","cloud","dart","flutter","serverless"],"created_at":"2024-08-01T12:01:12.272Z","updated_at":"2025-04-09T12:07:09.837Z","avatar_url":"https://github.com/celest-dev.png","language":"Dart","readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"./assets/logo-dark.png#gh-dark-mode-only\" width=\"500\"\u003e\n\u003cimg src=\"./assets/logo-light.png#gh-light-mode-only\" width=\"500\"\u003e\n\u003c/p\u003e\n\n## Celest\n\n\u003e [!WARNING]\n\u003e Celest is in the process of being open-sourced. During this process, many of the previously valid links like [celest.dev]() will be\n\u003e unavailable. We expect this process to be completed by the end of March 2025.\n\nCelest is the Flutter cloud platform. We enable Flutter and Dart developers to declaratively define their backend infrastructure in Dart.\n\nAnd to stay up-to-date on the future of Celest, including full server-side rendered Flutter apps, join our newsletter at [celest.dev](https://www.celest.dev/#stay-up-to-date).\n\n## Getting Started\n\nTo get started with Celest, you'll need to configure your development environment so that you have Flutter and the Celest CLI installed on your machine.\n\n1. Install [Flutter](https://docs.flutter.dev/get-started/install) from the official website\n2. [Download](https://celest.dev/download) and install the Celest CLI\n\n### Creating a project\n\nOnce you have the CLI installed, you can create a new project by running the following command:\n\n```bash\n$ celest init\n```\nYou can run this command from within your Flutter project which will create a new `celest/` directory for your project. Or you can run\nthis in another directory to have a standalone Celest project.\n\nOnce you have a project, run `celest start` to start a local development environment.\n\n```bash\n$ celest start\n✓ Celest is running on http://localhost:7777\n```\n\nThis command will start a local server which will run in the background as you write your backend logic. As you make changes to the files in the `celest/` directory, \nthe server will hot-reload those changes so you can see them live.\n\nTo interact with the running environment, Celest will generate a Dart client which you can use in any Dart or Flutter project. This client \nis generated in the `client/` directory of your `celest/` folder. As you make changes in the local environment, this client will be updated to reflect those changes.\n\n### Example\n\nHere is an example of a simple Celest function:\n\n```dart\nimport 'package:celest/celest.dart';\n\n@cloud\nFuture\u003cString\u003e sayHello(String name) async {\n  print('Saying hello to $name');\n  return 'Hello, $name';\n}\n```\n\nThis function can be called from a Dart project like so:\n\n```dart\nimport 'package:my_project_client/my_project_client.dart';\n\nFuture\u003cvoid\u003e main() async {\n  celest.init(environment: CelestEnvironment.local);\n  final response = await celest.functions.sayHello('World');\n  print(response); // Hello, World\n}\n```\n\n## What's Next?\n\nIn addition to Dart cloud functions, Celest offers authentication and database services out-of-the-box. To learn more about these features, \nand to see what else you can do with cloud functions, visit our [docs](https://celest.dev/docs) and explore the different examples and\npackages available in this repo.\n\n## Examples\n\n[![Celest](https://github.com/celest-dev/celest/actions/workflows/examples.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/examples.yaml)\n\n| Example                        | Description                                                                               |\n| ------------------------------ | ----------------------------------------------------------------------------------------- |\n| [Firebase](examples/firebase/) | Showcases how to integrate Firebase Auth with Celest.                                     |\n| [Gemini](examples/gemini/)     | Uses Google's [Gemini](https://ai.google.dev/) API for chat completion.                   |\n| [OpenAI](examples/openai/)     | Uses the [OpenAI](https://platform.openai.com/docs/introduction) API for chat completion. |\n| [Supabase](examples/supabase/) | Showcases how to integrate Supabase Auth with Celest.                                     |\n| [Tasks](examples/tasks/)       | Uses Celest Data to build a simple task tracking app with persistence.                    |\n\n## Packages\n\n| Package                                | Description                                                   | Pub                                                                                                                            | Checks                                                                                                                                                                          |\n| -------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [celest](packages/celest/)             | The main package for defining Celest backends.                | \u003ca href=\"https://pub.dev/packages/celest\" target=\"_blank\"\u003e \u003cimg src=\"https://img.shields.io/pub/v/celest.svg\"\u003e\u003c/a\u003e             | [![Celest](https://github.com/celest-dev/celest/actions/workflows/celest.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/celest.yaml)                   |\n| [celest_ast](packages/celest_ast/)     | A structured representation of Celest projects.               | \u003ca href=\"https://pub.dev/packages/celest_ast\" target=\"_blank\"\u003e \u003cimg src=\"https://img.shields.io/pub/v/celest_ast.svg\"\u003e\u003c/a\u003e     | [![Celest AST](https://github.com/celest-dev/celest/actions/workflows/celest_ast.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/celest_ast.yaml)       |\n| [celest_auth](packages/celest_auth/)   | The authentication and authorization runtimes for Celest.     | \u003ca href=\"https://pub.dev/packages/celest_auth\" target=\"_blank\"\u003e \u003cimg src=\"https://img.shields.io/pub/v/celest_auth.svg\"\u003e\u003c/a\u003e   | [![Celest Auth](https://github.com/celest-dev/celest/actions/workflows/celest_auth.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/celest_auth.yaml)    |\n| [celest_cloud](packages/celest_cloud/) | API contracts and Dart clients for the Celest Cloud platform. | \u003ca href=\"https://pub.dev/packages/celest_cloud\" target=\"_blank\"\u003e \u003cimg src=\"https://img.shields.io/pub/v/celest_cloud.svg\"\u003e\u003c/a\u003e | [![Celest Cloud](https://github.com/celest-dev/celest/actions/workflows/celest_cloud.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/celest_cloud.yaml) |\n| [celest_core](packages/celest_core/)   | Core types and utilities shared between Celest packages.      | \u003ca href=\"https://pub.dev/packages/celest_core\" target=\"_blank\"\u003e \u003cimg src=\"https://img.shields.io/pub/v/celest_core.svg\"\u003e\u003c/a\u003e   | [![Celest Core](https://github.com/celest-dev/celest/actions/workflows/celest_core.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/celest_core.yaml)    |\n\n## Services\n\n| Service                                          | Description                                                                                                                         | Pub                                                                                                                                      | Checks                                                                                                                                                                                         |\n| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [celest_cloud_auth](packages/celest_cloud_auth/) | A Dart-native authentication and authorization solution built on [Cedar](https://github.com/celest-dev/cedar-dart) and Celest Data. | \u003ca href=\"https://pub.dev/packages/celest_cloud_auth\" target=\"_blank\"\u003e \u003cimg src=\"https://img.shields.io/pub/v/celest_cloud_auth.svg\"\u003e\u003c/a\u003e | [![Celest Cloud Auth](https://github.com/celest-dev/celest/actions/workflows/celest_cloud_auth.yaml/badge.svg)](https://github.com/celest-dev/celest/actions/workflows/celest_cloud_auth.yaml) |\n\n## License\n\nThis repo is licensed under the [BSD-2-Clause-Patent](https://spdx.org/licenses/BSD-2-Clause-Patent.html) license. See [LICENSE.md](LICENSE.md) for the full text.\n\n## Connect with us\n\n- Follow our [Twitter](https://twitter.com/Celest_Dev) account.\n- Schedule a meeting or chat with us live: [Contact](https://celest.dev/contact)\n","funding_links":[],"categories":["Dart"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelest-dev%2Fcelest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcelest-dev%2Fcelest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelest-dev%2Fcelest/lists"}