/ftw-hourly

Flex template for Web: time-based booking processes

Primary LanguageJavaScriptOtherNOASSERTION

Sharetribe Flex Template for Web: time-based process

CircleCI

Note If you are using day-based booking process (i.e. daily or nightly bookings), you should choose the original Flex Template for Web instead.

This is a template web application for a Sharetribe Flex marketplace using time-based booking process. This repository is a fork from the existing FTW repository (which is using nightly booking process). So, if you have started working with the original FTW repository and you want to change to FTW-hourly, you can change the 'upstream' remote repository. You can read more about time-based process from the related Flex Docs article

Quick start

Note: this template assumes that you are using time-based transaction process with alias flex-hourly-default-process/release-1, if you are using something else, you should change the alias name from config.js and util/transaction.js

If you just want to get the app running quickly to test it out, first install Node.js and Yarn, and follow along:

git clone git@github.com:sharetribe/ftw-hourly.git             # clone this repository
cd ftw-hourly/                                                 # change to the cloned directory
yarn install                                                   # install dependencies
yarn run config                                                # add the mandatory env vars to your local config
yarn run dev                                                   # start the dev server, this will open a browser in localhost:3000

You can also follow along the Getting started with FTW tutorial and read the background article about Time-based template from the Flex Docs website.

For more information of the configuration, see the FTW Environment configuration variables reference in Flex Docs.

Note: If you want to build your own Flex marketplace on top of the template, you should fork the repository instead of cloning it. See the How to Customize FTW guide in Flex Docs.

For Windows users

Change export to set in the package.json file if you're using Windows/DOS. You need to do the change to "dev" and "dev-sever" commands.

"dev": "yarn run config-check&&set NODE_ENV=development REACT_APP_DEV_API_SERVER_PORT=3500&&concurrently --kill-others \"yarn run dev-frontend\" \"yarn run dev-backend\""
"dev-server": "set NODE_ENV=development PORT=4000 REACT_APP_CANONICAL_ROOT_URL=http://localhost:4000&&yarn run build&&nodemon --watch server server/index.js"

We strongly recommend installing Windows Subsystem for Linux, if you are developing on Windows. These templates are made for Unix-like web services which is the most common environment type on host-services for web apps. Also, Flex Docs uses Unix-like commands in articles instead of DOS commands.

Getting started with your own customization

If you want to build your own Flex marketplace by customizing the template application, see the How to Customize FTW guide in Flex Docs.

Deploying to Heroku

Note: Remember to fork the repository before deploying the application. Connecting your own Github repository to Heroku will make manual deploys easier.

See the How to deploy FTW to production guide in Flex Docs for more information.

Deploy

Documentation

See the Flex Docs site: https://www.sharetribe.com/docs/

See also the docs/ directory for some additional internal documentation.

Get help – join Sharetribe Flex Developer Slack channel

If you have any questions about development, the best place to ask them is the Flex Developer Slack channel at https://www.sharetribe.com/flex-slack

License

This project is licensed under the terms of the Apache-2.0 license.

See LICENSE