This repository has been archived by the owner on Jun 2, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
61f5036
commit a5c1ab0
Showing
1 changed file
with
49 additions
and
32 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,45 +1,62 @@ | ||
# Using | ||
<h3 align="center">Streaming list</h3> | ||
|
||
- [Vue.js (Vue 3)](https://vuejs.org/), "An approachable, performant and versatile framework for building web user interfaces." | ||
- [Twitch Search Server](https://github.com/Nickwasused/twitch-search-server), a custom Search for Twitch. | ||
<div align="center"> | ||
|
||
# Features | ||
[![Status](https://img.shields.io/badge/status-active-success.svg)]() | ||
[![License](https://img.shields.io/github/license/nickwasused/streaming-list)](/LICENSE) | ||
|
||
- PWA ([Progressive web application](https://wikiless.org/wiki/Progressive_web_application)) | ||
- SPA ([Single-page application](https://wikiless.org/wiki/single_page_application)) | ||
- [Tailwind css](https://tailwindcss.com/) | ||
- Automatic refresh (alt:V, Twitch) | ||
- Lazy loading images with ([Intersection Observer](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)) | ||
- Fast Builds (~12 seconds on Vercel) | ||
- Small Builds (0.28 MB, with external Font) | ||
- Caching API data in localstorage | ||
- Multi language support (Currently German and English) with Automatic detection. | ||
- Sort streams by Viewer count, Alphabetically, runtime or randomize the list. | ||
- Search streams by title or Username. | ||
- Show the status of the game server, e.g. if the server is online. | ||
- Tooltips to describe values. | ||
</div> | ||
|
||
# Preview | ||
--- | ||
|
||
![streaming-list-de-preview](./github-images/preview/preview-de.webp) | ||
![streaming-list-en-preview](./github-images/preview/preview-en.webp) | ||
<p align="center"> A searchable, auto-updating list of streamers for a certain topic. | ||
<br> | ||
</p> | ||
|
||
# Building and development | ||
## π Table of Contents | ||
- [About](#about) | ||
- [Getting Started](#getting_started) | ||
- [Deployment](#deployment) | ||
- [Usage](#usage) | ||
- [Built Using](#built_using) | ||
- [Affiliation](#affiliation) | ||
|
||
0. Make sure that you have [node 16+](https://nodejs.org/en/) installed with [PNPM](https://www.npmjs.com/package/pnpm) | ||
1. Start by cloning the repository: `git clone https://github.com/Nickwasused/streaming-list.git` | ||
2. Change into the directory and open a shell of some sort e.g. PowerShell, bash | ||
3. install the dependencies with: `pnpm i` | ||
4. now you can start developing with: `pnpm run dev` | ||
## π§ About <a name = "about"></a> | ||
A searchable, auto-updating list of streamers for a certain topic. | ||
|
||
You can get started by editing the .env file | ||
## π Getting Started <a name = "getting_started"></a> | ||
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See [deployment](#deployment) for notes on how to deploy the project on a live system. | ||
|
||
# Speed | ||
### Prerequisites | ||
What things you need to install the software and how to install them. | ||
|
||
## mobile | ||
`pnpm` [is required](https://pnpm.io/) | ||
`twitch-search-server` [instance is required](https://github.com/Nickwasused/twitch-search-server) | ||
|
||
![performance-mobile](./github-images/speed/mobile.webp) | ||
### Installing | ||
A step by step series of examples that tell you how to get a development env running. | ||
|
||
## desktop | ||
Install the dependencies with: | ||
|
||
![performance-desktop](./github-images/speed/desktop.webp) | ||
```console | ||
pnpm install | ||
``` | ||
|
||
Then you can open your browser and see the page at [http://127.0.0.1:3000/](http://127.0.0.1:3000/). | ||
|
||
## π Usage <a name="usage"></a> | ||
No extra notes. | ||
|
||
## π Deployment <a name = "deployment"></a> | ||
You can see a deployment example at [./.github/workflows/build-and-deploy.yml] | ||
|
||
## Style | ||
The code is formatted and checked with [prettier](https://prettier.io/)s default settings. | ||
|
||
## βοΈ Built Using <a name = "built_using"></a> | ||
- [Vue.js](https://vuejs.org/) - JavaScript Framework | ||
- [prettier](https://prettier.io/) - code formatter | ||
- [tailwindcss](https://tailwindcss.com/) - CSS framework | ||
- [pnpm](https://pnpm.io/) - package manager | ||
|
||
## Affiliation <a name = "affiliation"></a> |