Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/open-sauced/hot

πŸ•The site that recommends the hottest projects on GitHub.
https://github.com/open-sauced/hot

hacktoberfest pizza supabase vite vitejs

Last synced: 2 months ago
JSON representation

πŸ•The site that recommends the hottest projects on GitHub.

Awesome Lists containing this project

README

        

**This project has been archived in favor of the new Explore page, https://app.opensauced.pizza/explore**




Open Sauced

πŸ• hot.opensauced.pizza πŸ•


The site that recommends the hottest sauce. Inspired by daily.dev





Release


Compliance


CodeQL

Dependabot Badge
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`

We can also use one of the listed cloud providers we support:

## πŸ–₯️ 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
```

For writing tests, the rule is move business or service logic to the lib folder and write unit tests. Logic that needs to be in a React component, then leverage tools like [Cypress](https://www.cypress.io/) or [Vitest mocking](https://vitest.dev/guide/mocking.html) to write tests.

### πŸ“¦ Docker builds

A development preview can also be run from docker:

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

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

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

### 🎨 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
```

It is advised to run this command before committing or opening a pull request.

### πŸ“• Types

We have a couple of scripts to check and adjust missing types.

In order to dry run what types would be added to `package.json`:

```shell
npm run types:auto-check
```

In order to add any missing types to `package.json`:

```shell
npm run types:auto-add
```

### πŸš€ Production deployment

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

```shell
npm run build
```

## 🀝 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.

We have a commit utility called [@open-sauced/conventional-commit](https://github.com/open-sauced/conventional-commit) that helps you write your commits in a way that is easy to understand and process by others.

It is generally integrated as an `npm` script but you can run it with `npx` as well:

```shell
npm run push
```

For any other npm based project or dotnpmrc defaulting to `--yes`:

```shell
npx -y @open-sauced/conventional-commit
```

## πŸ• 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)