Skip to content

Apollo Universal Starter Kit is an 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.

License

Notifications You must be signed in to change notification settings

BaloPhilip/apollo-amplify-universal-starter-kit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Apollo Universal Starter Kit

Backers on Open Collective Sponsors on Open Collective Join the chat at https://gitter.im/sysgears/apollo-fullstack-starter-kit Build Status code style: prettier Twitter Follow

Use our chat to get help or discuss general topics about Apollo Universal Starter Kit.

Official Website

Visit apollokit.org to learn about Apollo Universal Starter Kit. You can also test a demo application deployed on Heroku.

Description

Apollo Universal Starter Kit is an SEO-friendly, fully configured, modular starter project for developing Universal JavaScript applications. You can use our kit to create your applications in JavaScript or TypeScript for all major platforms – mobile, web, and server.

Apollo Universal Starter Kit is built with Apollo, GraphQL, React, Angular, React Native, Expo, Knex.js, and Express with support for relational databases such as PostgreSQL, MySQL, and SQLite.

TypeScript is our language of choice and we use it across the entire project. However, you can freely mix vanilla JavaScript (the ES6 and ES7 syntax) and TypeScript when creating your modules.

The starter kit also integrates Twitter Bootstrap, Ant Design, Ant Design Mobile, and NativeBase to provide great possibilities for styling for your web and mobile applications.

Table of Contents

Overview

Why Use Apollo Universal Starter Kit

I am a Developer

  • Better productivity thanks to live reload and (partial) hot code reload
  • A fractal modular application architecture that's easy to support and extend
  • The possibility to create modules in TypeScript and JavaScript at the same time
  • No need to develop typical features for your applications
  • Zero project configuration thanks to SpinJS

I am a Project Manager

  • Your application will work faster thanks to GraphQL
  • Your team will be able to reuse the code for all the platforms
  • Your team can create client, server, and mobile JavaScript applications
  • Your application will be easier to support and evolve thanks to the fractal modular architecture
  • Your application will be based on a widely-used JavaScript ecosystem (it's easy to find JS developers)
  • Your team can develop new features straightaway instead of creating the basic features
  • Your application will be integrated with Stripe, one of the top payment processors

Concept

Developing client-server-mobile projects in JavaScript never was a trivial task. Not only do you have to spend time installing the application dependencies and configuring them, but you're also constrained to implement many basic functionalities over and over again. And you never have time for building a starter codebase that you can reuse across all of your projects.

To relieve you from the burden of configuring the project, building the application structure, and implementing typical features, we created Apollo Universal Starter Kit.

Apollo Universal Starter Kit provides you with a client-server-mobile application that you can employ as a foundation for developing new web or mobile projects using popular tools from the JavaScript ecosystem. But the starter kit doesn't just creates a mix of top JS technologies. In fact, the kit is powered by several custom libraries and solutions to simplify managing project configurations, creating new modules, building GraphQL queries, and perform many other tasks.

One such solution that helps to build and configure Apollo Universal Starter Kit without any complications is SpinJS, a custom build tool that configures the project for all the platforms – web, server, and mobile. With SpinJS, we drastically reduced the amount of errors caused by third-party libraries for building JavaScript projects.

The starter kit also consists of many modules that you can augment and adapt to build your specific application, or use as a reference when implementing basic features for your applications even if you build them using other technologies.

Architecture and Implemented Modules

Among all the approaches to building the application architecture, we opt for the disposable fractal-based modular architecture. Thanks to this approach, it's possible to remove any built-in module from Apollo Universal Starter Kit without breaking the application. We recommend that you develop your custom modules with the same idea in mind when using our starter kit.

Apollo Universal Starter Kit comes with the following modules:

  • Authentication. Authentication via social networks (Facebook, GitHub, LinkedIn, and Google using OAuth) and password-based authentication; refreshing a forgotten password
  • Authorization. Permission-based authorization with various user roles
  • Contact Us Form. Functionality to send messages to the server
  • Internationalization. A complete internationalization solution for the client and server
  • Mobile Chat. A live chat based on the React Native Gifted Chat and powered by GraphQL subscriptions
  • Pagination. Navigation between pages and presentation of entities
  • Payments. Functionality for recurring payments based on Stripe
  • Posts and Comments. Functionality to add, delete, and update posts and comments
  • State Management. The application state stored in the database and on the client using different approaches
  • 404 Not Found Page. A minimalistic module for handling 404 requests

To learn more about the features and modules available in Apollo Universal Starter Kit, follow to the dedicated section Features and Modules.

Demo

Here's a demo of Apollo Universal Starter Kit in action:

screencast

You can try out the latest version of Apollo Universal Starter Kit deployed on Heroku. If you want to see the mobile React Native application in action, check out this demo on Expo.io.

Branches

Branch Description
stable The latest stable version of the kit (recommended)
master The kit version with the latest features. May not work consistently
single A single-package Apollo v2 version of the kit
apollo1 The Apollo v1 version of the kit
cli-crud This kit version features a CLI to generate CRUD implementations

First Run of Apollo Universal Starter Kit

Verify if you use Node.js 6.x or higher (Node.js ^10 is recommended) before running the starter kit.

  1. Clone the stable branch of Apollo Universal Starter Kit.
git clone -b stable https://github.com/sysgears/apollo-universal-starter-kit.git
cd apollo-universal-starter-kit
  1. Install the dependencies. Make sure that you use Yarn 1.0.0 or higher.
yarn

You can use NPM instead of Yarn to handle the starter kit dependencies and to run scripts. Throughout the Apollo Universal Starter Kit documentation, we'll always use Yarn.

  1. Seed sample data to the database. The command below will create new tables with sample data in SQLite:
yarn seed

SQLite is a typical default relational database installed in most Linux distributions including Mac OS X; otherwise, consult SQLite installation guide.

  1. Run the starter kit in development mode:
yarn watch

The server application will be running on http://localhost:3000, while the client application will be running on http://localhost:8080. The terminal will tell your the exact ports.

For more information about running this starter kit for mobile development or Docker, consult the Getting Started guide.

Project Structure

The project structure presents generally accepted guidelines and patterns for building scalable web and mobile applications.

The structure is fractal meaning the functionality is grouped primarily by feature rather than by file type. But the current structure isn't prescriptive, and you can change it however you like.

apollo-universal-starter-kit
├── config                      # Various application configurations
├── docs                        # Documentation
├── node_modules                # Global Node.js modules
├── modules                     # Common project modules
├── packages                    # Application source code
│   ├── client                  # Front-end package
│   │   └── src
│   │   |   ├── app             # React application and common code
│   │   |   ├── modules         # Front-end feature-modules, each module has:
│   │   |   │                   # components, containers, GraphQL queries, and Redux reducers
│   │   |   ├── testHelpers     # Test helper for front-end integration tests
│   │   |   └── index.tsx       # Entry point to web front end with hot code reload
│   |   └── .spinrc.js          # Build configuration for the React application
|   ├── client-angular          # Front-end package
|   │   └── src
|   │   |   └── index.ts        # Entry point to Angular application
│   |   └── .spinrc.js          # Build configuration for the Angular application
│   ├── common                  # Yarn package with common code, a Redux store, and logging
│   ├── mobile                  # Mobile front-end package
│   │   └── src
│   │   |   └── index.ts        # Entry point to mobile front end with live code reload
│   |   └── .spinrc.js          # Build configuration for the server
│   └── server                  # Server package
│       ├── src
│       │   ├── api             # GraphQL API implementation
│       │   ├── database        # Database migrations and seeds
│       │   │   └── migrations  # Database migration scripts with Knex
│       │   │   └── seeds       # Database seed scripts with Knex
│       │   ├── middleware      # GraphQL Playground, GraphQL Express and SSR rendering
│       │   ├── modules         # Back-end feature-modules, each module has:
│       │   │                   # a schema definition, resolvers, and SQL queries
│       │   ├── sql             # Knex connector
│       │   ├── testHelpers     # Test helper for back-end integration tests
│       │   ├── server.js       # GraphQL API server setup
│       │   └── index.ts        # Entry point to back end with hot code reload
│       └── .spinrc.js          # Build configuration for the server
└── tools                       # All build and CLI-related files

Apollo Universal Starter Kit Documentation

Follow to the documentation concerning different aspects of how to run, configure, and develop with Apollo Universal Starter Kit.

Tools

Modules

Support

Community Support

  • Gitter channel – ask questions, find answers, and participate in general discussions
  • GitHub issues – submit issues and send feature requests
  • Wiki – read documentation for the usage scenarios of the starter kit; edit the documentation
  • FAQ – consult the Frequently Asked Questions section in Wiki

Commercial Support

The SysGears team provides comprehensive support for commercial partners. Our team can guide you when you're using Apollo Universal Starter Kit to build your application.

You can contact us via Skype or email [email protected].

Contributors

Thanks a lot to all the wonderful people who contributed to Apollo Universal Starter Kit!

Backers

Thanks a lot to all our backers!

Sponsors

You can support this project by becoming a sponsor! Your logo will show up here with a link to your website.

License

Copyright © 2016, 2017 SysGears INC. This source code is licensed under the MIT license.

About

Apollo Universal Starter Kit is an 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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 42.8%
  • Scala 31.2%
  • TypeScript 24.5%
  • Vue 0.6%
  • HTML 0.5%
  • CSS 0.4%