Skip to content

Open Source Application for running a Bicycle Coop Shop

License

Notifications You must be signed in to change notification settings

BridgeCityBicycleCoop/workstand-shop-app

Repository files navigation

🚲 Workstand - Shop App

⚠️ CAUTION: This project is under active development.

Workstand is a basic membership sign-in and bicycle management web application developed for the Bridge City Bicycle Co-operative (BCBC). It allows the BCBC to collect usage data for their shop. This helps with program planning, grant reporting, volunteer management, and more.

💻 Tech Stack

This app is developed using Sveltekit, Typescript, Superforms, and Pocketbase.

🏃‍♂️ Quickstart

Follow these steps to get the project up and running on your machine.

Setup Local Pocketbase DB

  1. Create your own local .env file.

    • see .env.example for an reference.
  2. Download and install Pocketbase

    • On macOS it's easiest to use Homebrew: brew install pocketbase
  3. Start Pocketbase: ./pocketbase serve

  4. Go to the Admin UI (via the URL in your terminal).

  5. It will prompt you to set up an email and password which will need to match your .env file.

  6. Manually create a user record in the users collection.

  7. Complete the development steps below, then login using the info created above.

Development

Once you've installed dependencies with npm install, start a development server:

npm run dev
# or start the server and open the app in a new browser tab
npm run dev -- --open

🚛 Deployment

To create a production version of your app:

npm run build

You can preview the production build with:

`npm run preview`.

NOTE: To deploy your app, you may need to install an adapter for your target environment. You will also need a place to host the Pocketbase server, which may be anywhere pocketbase can be installed but could also be a cloud provider like pockethost.io or Fly.io.

🥰 Code of Conduct

All contributors and maintainers are required to adhere to the Bridge City Bicycle Co-operative Policies. Please treat each other with the same respect and courtesy online as you would in person at the shop.

For questions, disputes, or clarifications, contact the BCBC Digital Committee at [email protected].

💌 Contribute

Workstand is currently under active development and is not ready to accept contributions. If you are interested in volunteering for the BCBC Digital Committee, please email [email protected] and we'd be happy to talk.