elk/README.md

76 lines
2.8 KiB
Markdown
Raw Normal View History

<p align="center">
<a href="https://viteconf.org" target="_blank" rel="noopener noreferrer">
<img width="180" src="https://elk.zone/logo.svg" alt="Vite logo">
</a>
</p>
<br/>
<p align="center">
<a href="https://chat.elk.zone"><img src="https://img.shields.io/badge/chat-discord-blue?style=flat&logo=discord" alt="discord chat"></a>
<a href="https://pr.new/elk-zone/elk"><img src="https://developer.stackblitz.com/img/start_pr_dark_small.svg" alt="Start new PR in StackBlitz Codeflow"></a>
</p>
<br/>
2022-11-13 06:34:43 +01:00
# Elk
2022-11-24 11:53:23 +01:00
2022-11-27 16:03:09 +01:00
A nimble Mastodon web client made with 🧡
2022-11-13 06:34:43 +01:00
2022-11-24 11:46:03 +01:00
Elk is in early alpha, but it is already quite usable. We would love your feedback and contributions.
2022-11-28 15:48:50 +01:00
Check out the [Open Issues](https://github.com/elk-zone/elk/issues) and jump in the action. Join the [Elk discord server](https://chat.elk.zone) to learn more and get involved!
2022-11-24 11:46:03 +01:00
The client is deployed to [elk.zone](https://elk.zone), you can share screenshots on social media but avoid sharing this URL or the discord server until we open the repo.
> **Note**
> If you would like to contribute, until the repo is open, please create branches in the main repository and send a PR from there.
# Contributing
Hi! We're really excited that you're interested in contributing to Elk! Before submitting your contribution, please read through the following guide.
## Online
You can use [StackBlitz CodeFlow](https://stackblitz.com/codeflow) to fix bugs or implement features. You'll also see a CodeFlow button on PRs to review them without a local setup.
[![Open in Codeflow](https://developer.stackblitz.com/img/open_in_codeflow.svg)](https://pr.new/elk-zone/elk)
## Local Setup
Clone the repository and run on the root folder:
```
pnpm i
pnpm run dev
```
We recommend installing [ni](https://github.com/antfu/ni#ni), that will use the right package manager in each of your projects. If `ni` is installed, you can instead run:
```
ni
nr dev
```
## Testing
Elk uses [Vitest](https://vitest.dev). You can run the test suite with:
```
nr test
```
2022-11-24 11:53:23 +01:00
2022-11-24 12:03:58 +01:00
# Stack
2022-11-24 14:15:29 +01:00
- [Vite](https://vitejs.dev/) - Next Generation Frontend Tooling
2022-12-01 16:15:41 +01:00
- [Nuxt](https://nuxt.com/) - The Intuitive Web Framework
2022-11-24 14:15:29 +01:00
- [Vue](https://vuejs.org/) - The Progressive JavaScript Framework
- [VueUse](https://vueuse.org/) - Collection of Vue Composition Utilities
2022-11-24 12:03:58 +01:00
- [Pinia](https://pinia.vuejs.org/) - The Vue Store that you will enjoy using
2022-11-24 14:15:29 +01:00
- [Vue Macros](https://vue-macros.sxzz.moe/) - More macros and syntax sugar for Vue
2022-11-24 12:03:58 +01:00
- [UnoCSS](https://uno.antfu.me/) - The instant on-demand atomic CSS engine
2022-11-24 14:15:29 +01:00
- [Iconify](https://github.com/iconify/icon-sets#iconify-icon-sets-in-json-format) - Iconify icon sets in JSON format
- [Masto.js](https://neet.github.io/masto.js) - Mastodon API client in TypeScript
- [shiki](https://shiki.matsu.io/) - A beautiful Syntax Highlighter
2022-11-24 12:03:58 +01:00
2022-11-24 11:53:23 +01:00
# License
MIT