{"id":13398443,"url":"https://github.com/sysgears/apollo-universal-starter-kit","last_synced_at":"2025-05-15T09:08:18.197Z","repository":{"id":11084854,"uuid":"67722021","full_name":"sysgears/apollo-universal-starter-kit","owner":"sysgears","description":"Apollo Universal Starter Kit is a SEO-friendly, fully-configured, modular starter application that helps developers to streamline web, server, and mobile development with cutting-edge technologies and ultimate code reuse.","archived":false,"fork":false,"pushed_at":"2023-12-14T12:10:09.000Z","size":18862,"stargazers_count":1679,"open_issues_count":93,"forks_count":322,"subscribers_count":61,"default_branch":"master","last_synced_at":"2025-05-12T23:22:34.800Z","etag":null,"topics":["angular","apollo","auth","docker","expo","graphql","ngrx","react","react-native","scala","starterkit","typescript","universal","webpack"],"latest_commit_sha":null,"homepage":"https://apollokit.org","language":"JavaScript","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/sysgears.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"open_collective":"apollo-universal-starter-kit"}},"created_at":"2016-09-08T16:44:45.000Z","updated_at":"2025-05-08T04:25:48.000Z","dependencies_parsed_at":"2023-12-14T13:41:46.551Z","dependency_job_id":null,"html_url":"https://github.com/sysgears/apollo-universal-starter-kit","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sysgears%2Fapollo-universal-starter-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sysgears%2Fapollo-universal-starter-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sysgears%2Fapollo-universal-starter-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sysgears%2Fapollo-universal-starter-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sysgears","download_url":"https://codeload.github.com/sysgears/apollo-universal-starter-kit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254310520,"owners_count":22049470,"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":["angular","apollo","auth","docker","expo","graphql","ngrx","react","react-native","scala","starterkit","typescript","universal","webpack"],"created_at":"2024-07-30T19:00:26.380Z","updated_at":"2025-05-15T09:08:13.181Z","avatar_url":"https://github.com/sysgears.png","language":"JavaScript","funding_links":["https://opencollective.com/apollo-universal-starter-kit"],"categories":["JavaScript","graphql","webpack","HarmonyOS","📦 Legacy \u0026 Inactive Projects"],"sub_categories":["Windows Manager"],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"#\"\u003e\u003cimg width=\"150\" src=\"https://rawgit.com/sysgears/apollo-universal-starter-kit/master/logo.svg\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n# Apollo Universal Starter Kit\n\n[![Backers on Open Collective](https://opencollective.com/apollo-universal-starter-kit/backers/badge.svg)](#backers)\n[![Sponsors on Open Collective](https://opencollective.com/apollo-universal-starter-kit/sponsors/badge.svg)](#sponsors)\n[![Join the chat at https://gitter.im/sysgears/apollo-fullstack-starter-kit](https://badges.gitter.im/sysgears/apollo-fullstack-starter-kit.svg)](https://gitter.im/sysgears/apollo-fullstack-starter-kit?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![Build Status](https://travis-ci.com/sysgears/apollo-universal-starter-kit.svg?branch=master)](https://travis-ci.com/sysgears/apollo-universal-starter-kit)\n[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)\n[![Twitter Follow](https://img.shields.io/twitter/follow/sysgears.svg?style=social)](https://twitter.com/sysgears)\n\n**Use [our chat] to get help or discuss general topics about Apollo Universal Starter Kit.**\n\n## Official Website\n\nVisit [apollokit.org] to learn about Apollo Universal Starter Kit. You can also test a [demo application] deployed on\nRender.\n\n## Description\n\n![](Technologies.png)\n\nApollo Universal Starter Kit is an SEO-friendly, fully configured, modular starter project for developing [Universal\nJavaScript] applications. You can use this kit to create your applications in JavaScript or TypeScript for all major\nplatforms \u0026ndash; mobile, web, and server.\n\nApollo Universal Starter Kit is built with [Apollo], [GraphQL], [React], [Angular], [React Native], [Expo], [Knex.js],\nand [Express] with support for relational databases such as PostgreSQL, MySQL, and SQLite.\n\n[TypeScript] is our language of choice and we use it across the entire project. However, you can freely mix vanilla\nJavaScript (the ES6 and ES7 syntax) and TypeScript when creating your modules.\n\nThe starter kit also integrates [Twitter Bootstrap], [Ant Design], and [NativeBase]\nto provide great possibilities for styling for your web and mobile applications.\n\n## Table of Contents\n\n* [Overview](#overview)\n    * [Why Use Apollo Universal Starter Kit](#why-use-apollo-universal-starter-kit)\n    * [Concept](#concept)\n    * [Architecture and Implemented Modules](#architecture-and-implemented-modules)\n* [Demo](#demo)\n* [Branches](#branches)\n* [First Run of Apollo Universal Starter Kit](#first-run-of-apollo-universal-starter-kit)\n* [Project Structure](#project-structure)\n* [Apollo Universal Starter Kit Documentation](#apollo-universal-starter-kit-documentation)\n* [Support](#support)\n    * [Community Support](#community-support)\n    * [Commercial Support](#commercial-support)\n* [Contributors](#contributors)\n* [Backers](#backers)\n* [Sponsors](#sponsors)\n* [License Info](#license)\n\n## Overview\n\n### Why Use Apollo Universal Starter Kit\n\n#### I am a Developer\n\n* Great productivity thanks to live reload and (partial) hot code reload\n* Fractal modular architecture that's easy to support and extend\n* The possibility to create modules in TypeScript _and_ JavaScript at the same time\n* No need to develop [typical features](#architecture-and-implemented-modules) for your applications\n\n#### I am a Project Manager\n\n* Your application will work faster thanks to GraphQL\n* Your team will be able to reuse the code for all the platforms\n* Your team can create client, server, and mobile JavaScript applications\n* Your application will be easier to support and evolve thanks to the fractal modular architecture\n* Your application will be based on a widely-used JavaScript ecosystem (it's easy to find JS developers)\n* Your team can develop new features straightaway instead of creating the basic features\n* Your application will be integrated with Stripe, one of the top payment processors\n\n### Concept\n\nDeveloping client-server-mobile projects in JavaScript never was a trivial task. Not only do you have to spend time\ninstalling the application dependencies and configuring them, but you're also constrained to implement many basic\nfunctionalities over and over again. And you never have time to develop a starter codebase that you can reuse across\nall of your projects.\n\nTo relieve you from the burden of configuring the project, developing the application structure, and implementing\ntypical features, we created Apollo Universal Starter Kit.\n\nApollo Universal Starter Kit provides you with a client-server-mobile application that you can employ as a foundation\nfor developing new web or mobile projects using popular tools from the JavaScript ecosystem. But our starter kit does so\nmuch more than just creating a mix of popular JS technologies \u0026mdash; it's powered by a few **custom** libraries and\nsolutions to simplify managing project configurations, creating new modules, building GraphQL queries, and perform many\nother tasks.\n\nThe starter kit also consists of many modules that you can augment and adapt to develop your specific application. Also,\nyou can use those prebuilt modules as a reference when implementing basic features for your applications even if you\ncreate them using other technologies.\n\n### Architecture and Implemented Modules\n\nAmong all the approaches to building the application architecture, we opt for the _disposable fractal-based modular\narchitecture_. Thanks to it, it's possible to remove any built-in module from Apollo Universal Starter Kit without\nbreaking the application. We recommend that you develop your custom modules with the same idea in mind when using our\nstarter kit.\n\nApollo Universal Starter Kit comes with the following modules:\n\n* **Authentication**. Authentication via social networks (Facebook, GitHub, LinkedIn, and Google using OAuth) and\npassword-based authentication; refreshing a forgotten password\n* **Authorization**. Permission-based authorization with various user roles\n* **Contact Us Form**. Functionality to send messages to the server\n* **Internationalization**. A complete internationalization solution for the client and server\n* **Mobile Chat**. A live chat based on the [React Native Gifted Chat] and powered by GraphQL subscriptions\n* **Pagination**. Navigation between pages and presentation of entities\n* **Payments**. Functionality for recurring payments based on Stripe\n* **Posts and Comments**. Functionality to add, delete, and update posts and comments\n* **State Management**. The application state stored in the database and on the client using different approaches\n* **404 Not Found Page**. A minimalistic module for handling 404 requests\n\nIf you don't want to use the pre-built modules in your project, you can remove them using a [dedicated CLI]. For module\nnames, see the names of directories under `modules`.\n\nTo learn more about the features and modules available in Apollo Universal Starter Kit, follow to the dedicated section\n[Features and Modules].\n\n## Demo\n\nHere's a demo of Apollo Universal Starter Kit in action:\n\n![screencast](https://user-images.githubusercontent.com/1259926/27387579-c6799ada-56a1-11e7-93fc-d08e9970640d.gif)\n\nYou can try out the latest version of Apollo Universal Starter Kit [deployed on Render]. If you want to see the mobile\nReact Native application in action, check out [this demo on Expo.io].\n\n## Branches\n\n| Branch       | Description                                                         |\n| ------------ | ------------------------------------------------------------------- |\n| [stable]     | The latest stable version of the kit (recommended)                  |\n| [master]     | The kit version with the latest features. May not work consistently |\n| [single]     | A single-package Apollo v2 version of the kit                       |\n| [apollo1]    | The Apollo v1 version of the kit                                    |\n| [cli-crud]   | This kit version features a CLI to generate CRUD implementations    |\n\n## First Run of Apollo Universal Starter Kit\n\nVerify if you use Node.js 6.x or higher (Node.js ^10 is recommended) before running the starter kit.\n\n1. Clone the stable branch of Apollo Universal Starter Kit.\n\n```\ngit clone -b stable https://github.com/sysgears/apollo-universal-starter-kit.git\ncd apollo-universal-starter-kit\n```\n\n**NOTE**: The master branch is not recommended for development. Use it at your own risk.\n\n**NOTE**: If you're going to use Windows to develop with Apollo Universal Starter Kit, you need to additionally enable\nsymlinks _before_ you run the project.\n\nFor Windows 10:\n\n* Press `Win` + `I` to open **Settings**\n* Click **Update \u0026 Security**\n* Click the **For Developers** tab\n* In the **Use developer features** window, switch to **Developer Mode**\n\n**NOTE**: You can remove the unnecessary stacks from Apollo Universal Starter Kit by using the CLI. Consult a\n[respective CLI section]. Alternatively, you can use the capabilities of your operating system. For example, by running\nthe command below, you can remove all Scala server files:\n\n```bash\nfind . -name server-scala | xargs rm -rf\n```\n\nIf you don't need the ready-made modules, you can also remove them using the [custom CLI].\n\n2. Install the dependencies. Make sure that you use Yarn 1.0.0 or higher.\n\n```\nyarn\n```\n\nYou can use NPM instead of Yarn to handle the starter kit dependencies and to run scripts. Throughout the Apollo\nUniversal Starter Kit documentation, we'll always use Yarn.\n\n3. Seed sample data to the database. The command below will create new tables with sample data in SQLite:\n\n```\nyarn seed\n```\n\nSQLite is a typical default relational database installed in most Linux distributions including Mac OS X; otherwise,\nconsult [SQLite installation guide].\n\n4. Run the starter kit in development mode:\n\n```\nyarn watch\n```\n\nThe server application will be running on [http://localhost:3000], while the client application will be running on\n[http://localhost:8080]. The terminal will tell your the exact ports.\n\nFor more information about running this starter kit for mobile development or Docker, consult the [Getting Started]\nguide.\n\n## Project Structure\n\nThe project structure presents generally accepted guidelines and patterns for building scalable web and mobile\napplications.\n\nThe structure is _fractal_ meaning the available functionality is grouped primarily by feature rather than by file type.\nBut the current structure isn't prescriptive, and you can change it however you like.\n\n```\napollo-universal-starter-kit\n├── config                      # Various application configurations\n├── docs                        # Documentation\n├── node_modules                # Global Node.js modules\n├── modules                     # All the prebuilt project modules\n├── packages                    # Available packages\n│   ├── client                  # React client\n│   ├── client-angular          # Angular client\n│   ├── client-vue              # Vue client\n│   ├── common                  # Common code\n│   ├── mobile                  # React Native mobile client\n│   ├── server                  # Node.js and Express server\n│   └── server-scala            # Scala server\n└── tools                       # All build and CLI-related files\n```\n\nInside `modules`, you'll find all the prebuilt modules that Apollo Universal Starter Kit comes with. Each module under\n`modules` contains sub-directories with module implementations for different technologies. For example, if you look up\nthe module `modules/core`, you'll see the following sub-modules:\n\n```\napollo-universal-starter-kit\n├── modules                       # Available packages\n│   ├── core                      # The core module\n│       ├── client-angular        # Core functionality for Angular app\n│       ├── client-react          # Core functionality for React app\n│       ├── client-react-native   # Core functionality for React Native app\n│       ├── client-vue            # Core functionality for Vue app\n│       ├── common                # React Native mobile client\n│       ├── server-scala          # Core functionality for Scala server\n│       └── server-ts             # Core functionality for Express server\n└── tools                         # All build and CLI-related files\n```\n\n\n## Apollo Universal Starter Kit Documentation\n\nFollow to the documentation concerning different aspects of how to run, configure, and develop with Apollo Universal\nStarter Kit.\n\n* [Getting Started]\n    * [Installing and Running Apollo Universal Starter Kit]\n    * [Running the Mobile App with Expo]\n    * [Running the Starter Kit in a Mobile Simulator]\n* [Running Apollo Universal Starter Kit with Docker]\n* [Deploying Apollo Universal Starter Kit to Production]\n* [Configuring Apollo Universal Starter Kit]\n* [Features and Modules]\n* [Writing Code]\n* [Debugging Code]\n* [Available Scripts]\n* [Frequently Asked Questions]\n* [Project Structure]\n* [Importing Modules]\n\nTools\n\n* [Apollo Universal Starter Kit CLI]\n\nModules\n\n* [Stripe Payments]\n* [Mobile Chat]\n\n## Support\n\n### Community Support\n\n* [Gitter channel] \u0026ndash; ask questions, find answers, and participate in general discussions\n* [GitHub issues] \u0026ndash; submit issues and send feature requests\n* [Wiki] \u0026ndash; read documentation for the usage scenarios of the starter kit; edit the documentation\n* [FAQ] \u0026ndash; consult the Frequently Asked Questions section\n\n### Commercial Support\n\nThe [SysGears] team provides comprehensive support for commercial partners. Our team can guide you when you're using\nApollo Universal Starter Kit to build your application.\n\nYou can contact us via [Skype] or email [info@sysgears.com](mailto:info@sysgears.com).\n\n## Contributors\n\nThanks a lot to all the wonderful people who contributed to Apollo Universal Starter Kit!\n\n\u003ca href=\"https://github.com/sysgears/apollo-universal-starter-kit/graphs/contributors\"\u003e\n    \u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/contributors.svg?width=890\" /\u003e\n\u003c/a\u003e\n\n## Backers\n\nThanks a lot to all our backers!\n\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit#backers\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/backers.svg?width=890\"\u003e\u003c/a\u003e\n\n## Sponsors\n\nYou can support this project by becoming a sponsor! Your logo will show up here with a link to your website.\n\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/0/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/0/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/1/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/1/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/2/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/2/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/3/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/3/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/4/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/4/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/5/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/5/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/6/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/6/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/7/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/7/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/8/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/8/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/9/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/apollo-universal-starter-kit/sponsor/9/avatar.svg\"\u003e\u003c/a\u003e\n\n## License\n\nCopyright \u0026copy; 2016-2019 [SysGears (Cyprus) Limited]. This source code is licensed under the [MIT] license.\n\n[our chat]: https://gitter.im/sysgears/apollo-fullstack-starter-kit\n[mit]: LICENSE\n[universal javascript]: https://medium.com/@mjackson/universal-javascript-4761051b7ae9\n[apollo]: http://www.apollostack.com\n[graphql]: http://graphql.org\n[jwt]: https://jwt.io\n[react]: https://reactjs.org/\n[angular]: https://angular.io/\n[react native]: https://facebook.github.io/react-native/\n[expo]: https://expo.io/\n[knex.js]: http://knexjs.org\n[express]: http://expressjs.com\n[typescript]: https://www.typescriptlang.org/\n[twitter bootstrap]: http://getbootstrap.com\n[ant design]: https://ant.design\n[nativebase]: https://nativebase.io\n[apollokit.org]: https://apollokit.org\n[demo application]: https://ausk.sysgears.com\n[react native gifted chat]: https://github.com/FaridSafi/react-native-gifted-chat\n[deployed on render]: https://ausk.sysgears.com\n[this demo on Expo.io]: https://expo.io/@sysgears/apollo-universal-starter-kit\n[stable]: https://github.com/sysgears/apollo-universal-starter-kit/tree/stable\n[master]: https://github.com/sysgears/apollo-universal-starter-kit/tree/master\n[single]: https://github.com/sysgears/apollo-universal-starter-kit/tree/single\n[apollo1]: https://github.com/sysgears/apollo-universal-starter-kit/tree/apollo1\n[cli-crud]: https://github.com/sysgears/apollo-universal-starter-kit/tree/cli-crud\n[custom cli]: https://github.com/sysgears/apollo-universal-starter-kit/tree/cli-crud\n[sqlite installation guide]: http://www.sqlitetutorial.net/download-install-sqlite/\n[http://localhost:3000]: http://localhost:3000\n[http://localhost:8080]: http://localhost:8080\n[getting started]: /docs/Getting%20Started.md\n[installing and running apollo universal starter kit]: /docs/Getting%20Started.md#installing-and-running-apollo-universal-starter-kit\n[running the mobile app with expo]: /docs/Getting%20Started.md#running-the-mobile-app-with-expo\n[running the starter kit in a mobile simulator]: /docs/Getting%20Started.md#running-the-starter-kit-in-a-mobile-simulator\n[running apollo universal starter kit with docker]: /docs/Docker.md\n[deploying apollo universal starter kit to production]: /docs/Deployment.md\n[configuring apollo universal starter kit]: /docs/Configuration.md\n[dedicated cli]: /docs/tools/CLI.md#deleting-features-with-deletemodule\n[respective cli section]: /docs/tools/CLI.md#selecting-the-technology-stack-with-choosestack\n[features and modules]: /docs/Features%20and%20Modules.md\n[writing code]: /docs/Writing%20Code.md\n[debugging code]: /docs/Debugging.md\n[apollo universal starter kit cli]: /docs/tools/CLI.md\n[available scripts]: /docs/Yarn%20Scripts.md\n[stripe payments]: /docs/modules/Stripe%20Subscription.md\n[mobile chat]: /docs/modules/Mobile%20Chat.md\n[project structure]: /docs/Project%20Structure.md\n[importing modules]: /docs/Importing%20Modules.md\n[frequently asked questions]: /docs/FAQ.md\n[sysgears (cyprus) limited]: http://sysgears.com\n[gitter channel]: https://gitter.im/sysgears/apollo-fullstack-starter-kit\n[github issues]: https://github.com/sysgears/apollo-universal-starter-kit/issues\n[wiki]: https://github.com/sysgears/apollo-universal-starter-kit/wiki\n[faq]: /docs/FAQ.md\n[sysgears]: https://sysgears.com\n[skype]: http://hatscripts.com/addskype?sysgears\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsysgears%2Fapollo-universal-starter-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsysgears%2Fapollo-universal-starter-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsysgears%2Fapollo-universal-starter-kit/lists"}