{"id":13880635,"url":"https://github.com/appwrite/sdk-generator","last_synced_at":"2026-04-15T09:04:28.175Z","repository":{"id":37405635,"uuid":"188078602","full_name":"appwrite/sdk-generator","owner":"appwrite","description":"Generating SDKs for multiple programming languages and platforms ⚙️","archived":false,"fork":false,"pushed_at":"2026-01-12T10:53:16.000Z","size":26775,"stargazers_count":307,"open_issues_count":54,"forks_count":192,"subscribers_count":22,"default_branch":"master","last_synced_at":"2026-01-12T13:25:59.912Z","etag":null,"topics":["dart","flutter","hacktoberfest","javascript","js","kotlin","multiple-languages","nodejs","php","python","ruby","sdk-generator","swift","web"],"latest_commit_sha":null,"homepage":"https://appwrite.io","language":"Twig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/appwrite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-05-22T16:47:41.000Z","updated_at":"2026-01-12T08:42:01.000Z","dependencies_parsed_at":"2023-11-16T04:26:52.754Z","dependency_job_id":"f1056c11-a295-426e-9a1b-ca0fc641ac9f","html_url":"https://github.com/appwrite/sdk-generator","commit_stats":{"total_commits":4184,"total_committers":92,"mean_commits":45.47826086956522,"dds":0.7997131931166348,"last_synced_commit":"4e9f23eceb5a283b878f7a4a98b700b4bc6563c8"},"previous_names":[],"tags_count":311,"template":false,"template_full_name":null,"purl":"pkg:github/appwrite/sdk-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appwrite%2Fsdk-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appwrite%2Fsdk-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appwrite%2Fsdk-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appwrite%2Fsdk-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appwrite","download_url":"https://codeload.github.com/appwrite/sdk-generator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appwrite%2Fsdk-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28508859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T11:50:55.898Z","status":"ssl_error","status_checked_at":"2026-01-17T11:50:55.569Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["dart","flutter","hacktoberfest","javascript","js","kotlin","multiple-languages","nodejs","php","python","ruby","sdk-generator","swift","web"],"created_at":"2024-08-06T08:03:20.259Z","updated_at":"2026-01-17T12:56:58.095Z","avatar_url":"https://github.com/appwrite.png","language":"Twig","readme":"# ⚙️ Appwrite SDK Generator\n\n[![Discord](https://img.shields.io/discord/564160730845151244?label=discord\u0026style=flat-square)](https://appwrite.io/discord)\n[![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)\n[![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee\u0026label=twitter\u0026style=flat-square)](https://twitter.com/appwrite)\n[![Follow Appwrite on StackShare](https://img.shields.io/badge/follow%20on-stackshare-blue?style=flat-square)](https://stackshare.io/appwrite)\n[![appwrite.io](https://img.shields.io/badge/appwrite-.io-f02e65?style=flat-square)](https://appwrite.io)\n\n**WORK IN PROGRESS - NOT READY FOR GENERAL USAGE**\n\n[Appwrite](https://appwrite.io) SDK generator is a PHP library for auto-generating SDK libraries for multiple languages and platforms.\n\nThe SDK Generator uses predefined language settings as [Twig templates](https://twig.symfony.com/) to generate codebases based on different API specs.\n\nCurrently, the only spec supported is Swagger 2.0, but we intend to add support for more specifications in the near future. This generator is still lacking support for any definition/model specs.\n\n## Getting Started\n\nInstall using composer:\n\n**CLI**\n```bash\ncomposer update --ignore-platform-reqs --optimize-autoloader\n```\n\n**Docker (UNIX)**\n\n```bash\ndocker run --rm --interactive --tty --volume \"$(pwd)\":/app composer install --ignore-platform-reqs\n```\n\n**Docker (Windows)**\n\n```bash\ndocker run --rm --interactive --tty --volume \"%cd%\":/app composer install --ignore-platform-reqs\n```\n\nCreate language and SDK instances and generate code to target directory.\n\n```php\n\u003c?php\n\nrequire_once 'vendor/autoload.php';\n\nuse Appwrite\\Spec\\Swagger2;\nuse Appwrite\\SDK\\SDK;\nuse Appwrite\\SDK\\Language\\PHP;\n\n// Read API specification file (Swagger 2) and create spec instance\n$spec = new Swagger2(file_get_contents('https://appwrite.io/v1/open-api-2.json?extension=1'));\n\n// Create language instance\n$lang = new PHP();\n\n$lang // Set language or platform specific options\n    -\u003esetComposerPackage('my-api')\n    -\u003esetComposerVendor('my-company')\n;\n\n// Create the SDK object with the language and spec instances\n$sdk  = new SDK($lang, $spec);\n\n$sdk\n    -\u003esetLogo('https://appwrite.io/v1/images/console.png')\n    -\u003esetLicenseContent('License content here.')\n    -\u003esetVersion('v1.1.0')\n;\n\n$sdk-\u003egenerate(__DIR__ . '/examples/php'); // Generate source code\n\n```\n\n## Linting Twig Templates\n\nThis project uses [djLint](https://djlint.com/) to lint Twig template files for syntax and common issues.\n\n**Note:** Formatting is disabled as it breaks code generation syntax. Only linting is used.\n\n**Available command:**\n```bash\ncomposer lint-twig  # Check for linting errors\n```\n\nRequires [uv](https://github.com/astral-sh/uv) to be installed. Configuration is in `pyproject.toml`. The linter runs automatically on pull requests via GitHub Actions.\n\n## Supported Specs\n\n* [Swagger 2](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md)\n* [OpenAPI 3](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md) (Not Ready)\n* [RAML 1.0](https://raml.org/) (Not Ready)\n* [RAML 0.8](https://raml.org/) (Not Ready)\n* [Postman 2.0](https://schema.getpostman.com/json/collection/v2.0.0/docs/index.html) (Not Ready)\n* [Postman 1.0](https://schema.getpostman.com/json/collection/v1.0.0/docs/index.html) (Not Ready)\n* [API Blueprint 1A](https://github.com/apiaryio/api-blueprint/blob/master/API%20Blueprint%20Specification.md) (Not Ready)\n\n## Supported Client / Platform SDKs\n\n| Language               | Supported Versions  |  Coding Standards      |  Package Manager   |   Maintainer   |\n|------------------------|---------------------|------------------------|--------------------|----------------|\n| Web                    | ES5+                | [NPM Coding Style]     | NPM, Yarn,         | [@eldadfux]    |\n| Flutter                |                     | [Effective Dart]       | pub tool           | [@bartektartanus] [@Almoullim] [@lohanidamodar]   |\n| Android (Kotlin, Java) | 5.0+                | [Android style guide]  | Gradle, Maven      | [@abnegate]    |\n| iOS, macOS (Swift)     | iOS 15+, macOS 11+  | [Swift Style Guide]    | Swift Pkg Manager  | [@abnegate]    |\n| Unity (Csharp)         |                     |                        | ?                  | [You?](https://github.com/appwrite/sdk-generator/issues/20) |\n\n## Supported Server SDKs\n\n| Language   | Supported Versions  |  Coding Standards      |  Package Manager   | Contributors   |\n|------------|---------------------|------------------------|--------------------|----------------|\n| TypeScript |                     | [NPM Coding Style]     | NPM, Yarn          | [@eldadfux]    |\n| NodeJS     | 8, 10, 12           | [NPM Coding Style]     | NPM, Yarn          | [@eldadfux]    |\n| PHP        | 7.0+                | [PHP FIG]              | Composer           | [@eldadfux]    |\n| Ruby       | 2.4+                | [Ruby Style Guide]     | GEM                | [@eldadfux] [@abnegate] |\n| Python     | 3.5+                | [PEP8]                 | PIP                | [@eldadfux] [@abnegate] |\n| Dart       | 2.7+                | [Effective Dart]       | pub                | [@lohanidamodar] |\n| Go         |                     | [Effective Go]         | go get             | [@panz3r] [@phaus]      |\n| .NET       | .NET core 3.1       | [C# Coding Conventions]| NuGet              | [@komemi] [@TorstenDittmann]     |\n| D          |                     |                        | ?                  | [You?](https://github.com/appwrite/sdk-generator/issues/20) |\n| Kotlin     | 1.4.31+             | [Kotlin style guide]   | Gradle, Maven      | [@abnegate]    |\n| Java       | 8+                  | [Google style guide]   | Gradle, Maven      | [@abnegate]    |\n| Swift      | 5.5+                | [Swift Style Guide]    | Swift Pkg Manager  | [@abnegate]    |\n| Docker CLI |                     |                        | Docker Hub         | [@christyjacob4]  |\n\n[@Almoullim]:           https://github.com/Almoullim\n[@eldadfux]:            https://github.com/eldadfux\n[@panz3r]:              https://github.com/panz3r\n[@armino-dev]:          https://github.com/armino-dev\n[@bartektartanus]:      https://github.com/bartektartanus\n[@komemi]:              https://github.com/komemi\n[@TorstenDittmann]:     https://github.com/TorstenDittmann\n[@lohanidamodar]:       https://github.com/lohanidamodar\n[@christyjacob4]:       https://github.com/christyjacob4\n[@abnegate]:            https://github.com/abnegate\n\n[PHP FIG]:              https://www.php-fig.org/\n[NPM Coding Style]:     https://docs.npmjs.com/misc/coding-style\n[NPM Coding Style]:     https://docs.npmjs.com/misc/coding-style\n[Ruby Style Guide]:     https://github.com/rubocop-hq/ruby-style-guide\n[PEP8]:                 https://www.python.org/dev/peps/pep-0008/\n[Effective Dart]:       https://dart.dev/guides/language/effective-dart/style\n[Effective Go]:         https://golang.org/doc/effective_go.html\n[Swift Style Guide]:    https://google.github.io/swift/\n[C# Coding Conventions]:https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions\n[Kotlin style guide]:   https://kotlinlang.org/docs/coding-conventions.html#apply-the-style-guide\n[Android style guide]:  https://developer.android.com/kotlin/style-guide\n[Google style guide]:   https://google.github.io/styleguide/javaguide.html\n\n## Contributing\n\nAll code contributions, including those by people with commit access, must go through a pull request and be approved by a core developer before being merged. This is to ensure proper review of all the code.\n\nWe truly ❤️ pull requests! If you wish to help, you can learn more about how you can contribute to this project in the [contribution guide](CONTRIBUTING.md).\n\n## Copyright and license\n\nThe MIT License (MIT) http://www.opensource.org/licenses/mit-license.php\n","funding_links":[],"categories":["Twig"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappwrite%2Fsdk-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappwrite%2Fsdk-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappwrite%2Fsdk-generator/lists"}