Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hew/bazaar

๐Ÿคน Build x-platform React apps bizarrely fast.
https://github.com/hew/bazaar

Last synced: 3 months ago
JSON representation

๐Ÿคน Build x-platform React apps bizarrely fast.

Awesome Lists containing this project

README

        

[![GitHub license](https://img.shields.io/github/license/Naereen/StrapDown.js.svg)](https://github.com/Naereen/StrapDown.js/blob/master/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

# Bazaar

> Have a look around. Maybe you see something you like?

## Demo

https://web-build-jhmnnfnztq.now.sh

(Log in using the demo credentials provided.)

## What & Why

Bazaar is an opinionated boilerplate for building apps quickly and easily. Here's what you get:

**Backend**
* [Amplify (optional)](https://github.com/aws-amplify/amplify-js) โ€“ for backend data and authentication

**Frontend**
* [Expo / React Native](https://github.com/expo/expo) โ€“ for x-platform compilation (with web support)
* [React](https://github.com/facebook/react) โ€“ Hooks API
* [React Navigation](https://reactnavigation.org) โ€“ for navigation
* [React Spring](https://github.com/react-spring/react-spring) โ€“ for animation
* [theme-ui](https://github.com/system-ui/theme-ui) โ€“ for consistent, scalable styles
* [@xstate/react](https://github.com/davidkpiano/xstate) โ€“ state machine context hooks

**Tools & Testing**
* [Yarn Workspaces](https://yarnpkg.com/lang/en/docs/workspaces) โ€“ for working with multiple Amplify lambdas
* [Ava (optional)](https://github.com/avajs/ava) โ€“ for testing lambdas/backend
* [Jest](https://github.com/facebook/jest) โ€“ for testing the front end
* [Eslint](https://eslint.org/) โ€“ for syntactical hints
* [Prettier](https://eslint.org/) โ€“ for structural consistency

## Getting Started

* ``yarn`` - install dependencies
* ``yarn workspace frontend run start`` - start up the app in development mode
* ``yarn workspace frontend add package`` - add a package to the frontend
* ``yarn add package -W`` - add a package to the root

## Documentation

* [Frontend](https://github.com/hew/bazaar/tree/master/frontend)
* [Backend](https://aws-amplify.github.io/docs/)

## FAQ

**Question**: *Why the name Bazaar*?

**Answer**: I googled 'expo synonyms' and this was the only one I liked.

**Question**: *Not Lerna + NPM*?

**Answer**: Lerna [uses Workspaces](https://github.com/lerna/lerna/pull/899) a bit, so I kinda like the idea of one package
manager just handling everything.

## Thanks & Inspiration

* Thanks to all the library authors for making such enjoyable tools.
* Additional thanks to Brent Jackson, author of theme-ui, styled-system, etc, for inspiration.