Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/0-vortex/open-sauced-hot-vite-ts-test

Experimenting with vite typescript template rewrite for hot.opensauced.pizza
https://github.com/0-vortex/open-sauced-hot-vite-ts-test

Last synced: 9 days ago
JSON representation

Experimenting with vite typescript template rewrite for hot.opensauced.pizza

Awesome Lists containing this project

README

        




Open Sauced

๐Ÿ• Open Sauced Vite Typescript Template Test ๐Ÿ•


The path to your next Open Source contribution




GitHub code size in bytes
GitHub commit activity

GitHub issues


GitHub Release


Discord


Twitter

## ๐Ÿ“– Prerequisites

In order to run the project we need the following software binaries installed on our development machines:
- `node>=16.7.0`
- `npm>=8.0.0`
- `docker>=20.10.12`
- `supabase>=0.18.0`

## ๐Ÿ–ฅ๏ธ Local development

To install the application:

```shell
npm ci
```

To start a local copy of the app on port `3000`:

```shell
npm start
```

### ๐Ÿงช Test

For running the test suite, use the following command. Since the tests run in watch mode by default, some users may encounter errors about too many files being open. In this case, it may be beneficial to [install watchman](https://facebook.github.io/watchman/docs/install.html).

```shell
npm test
```

You can request a coverage report by running the following command:

```shell
npm run test:coverage
```

### ๐Ÿ“ฆ Docker builds

A development preview can also be run from docker:

```shell
docker build -t open-sauced-template .
docker run -p 8080:80 open-sauced-template
```

Alternatively you can pull the production container and skip all builds:

```shell
docker run -dit -p 8080:80 ghcr.io/open-sauced/open-sauced
```

### ๐ŸŽจ Code linting

To check the code and styles quality, use the following command:

```shell
npm run lint
```

This will also display during development, but not break on errors.

To fix the linting errors, use the following command:

```shell
npm run format
```

### ๐Ÿš€ Production deployment

A production deployment is a complete build of the project, including the build of the static assets.

```shell
npm run build
```

You can analyze the build by running the following command:

```shell
npm run build:analyze
```

### ๐ŸŽญ Offline asset optimization

We also have a script for updating `.svg` files used in the project, you only need to run this if you add new assets:

```shell
npm run build:svgo
```

And one for `.png` and `.jpg` files:

```shell
npm run build:squoosh
```

### ๐Ÿšง Development debugging

Thanks to [antfu/vite-plugin-inpesct](https://github.com/antfu/vite-plugin-inspect) we can always inspect the bundles in development by navigating to [localhost:3000/__inspect/](http://localhost:3000/__inspect/) in your browser.

## ๐Ÿค Contributing

We encourage you to contribute to Open Sauced! Please check out the [Contributing guide](https://docs.opensauced.pizza/contributing/introduction-to-contributing/) for guidelines about how to proceed.

## ๐Ÿ• Community

Got Questions? Join the conversation in our [Discord](https://discord.gg/U2peSNf23P).
Find Open Sauced videos and release overviews on our [YouTube Channel](https://www.youtube.com/channel/UCklWxKrTti61ZCROE1e5-MQ).

## ๐ŸŽฆ Repository Visualization

[![Visualization of this repository](./public/diagram.svg)
](./src)

## โš–๏ธ LICENSE

MIT ยฉ [Open Sauced](LICENSE)