ElasticDev Starter Kit

Elastic, Serverless, Universal... oh my! 💫

ESK is a toolkit for universal, serverless, schema-first, immutable, reactive, functional and progressive applications using React & GraphQL as a platform at its core.

• Motivation
• Features
• Built With
• Why you shouldn't use this
• Docs
  • Configuration
  • Deploying
  • Examples
  • API Reference
• Developing
  • Prerequisites
  • Setting up Dev
  • Create an environment file
  • Start development
• Versioning
• Tests
• Style guide
• Licensing
• Contributing
  • Code of Conduct
• Contributors

A starter kit for quickly developing universal applications powered by React, GraphQL, functional, serverless, and reactive concepts. Includes web, mobile and desktop platforms, with more to come.

ESK reduces boilerplate to the absolute minimum, and thrives to make application development simpler by encapsulating common constructs, patterns, models and relationships common to most apps.

This "incidental" architecture that we build just in order to get our business feature development going is minimized, letting you focus on the core values of your application. Project setup and configuration, authentication, payments, search, social features, among others, are handled for you and ready to be extended to accommodate your application requirements.

• React
• React Native
• NextJS
• GraphQL
• Apollo Client
• Glamorous
• React Primitives
• Electron
• Ramda
• generator-bxd-oss

TODO: List other main libraries, frameworks used including versions.

It's not common for projects to include an anti-pitch, but in the interest of transparency, we thought it would help you evaluate whether to use (or contribute to) this project. You're always welcome to help, and we will be removing these points accordingly if we feel we've made significant process and there are no longer relevant, we might be adding some too.

• 🔥 This project is really unstable and on the earliest phases you can think of.
• 💥 This project is very ambitious, we might not complete everything there's to it ¯_(ツ)_/¯.
• 💦 This project is very opinionated, a plugin architecture is in our roadmap, but for now the technology and pattern choices made will probably have to resonate with you in order to be used effectively.
• 👀 Tooling across the ecosystem is not there yet, so we have patches all over the place.
• 👎 If serverless isn't for you or your organization.
• 🙉 If you're not building universal apps.
• 😾 If you're looking for something simple. We'll simplify our API and usage when we're closing in on 1.0.

TODO

TODO: give more detailed instructions on how to build and release a new version In case there's some step you have to take that publishes this project to a server, this is the right time to state it.

• TodoMVC

TODO: Link to deployed GraphQL playground, Documentation.js generated docs, etc.

• Install NodeJS.
• Install Yarn.

Here's a brief intro about what a developer must do in order to start developing the project further:

git clone https://github.com/blackxored/elasticdev-starter-kit.git
cd elasticdev-starter-kit/
yarn

TODO

yarn dev

We use SemVer for versioning. In addition, it's automatic via semantic-release, and our commit convention.

For the versions available, see the Releases on this repository.

yarn test

We use most of AirBnB's style guide and we check with ESLint and automatically format our code with Prettier

This project is licensed under the MIT License - see the license file for details.

If you're interested in contributing to this project in any form, please read our Contribution Guidelines.

We've adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Thanks goes to these wonderful people (emoji key):

Adrian Perez 💻 📖 🚇 🎨 👀 🤔

This project follows the all-contributors specification. Contributions of any kind welcome!