docs/README.md

63 lines
2.9 KiB
Markdown
Raw Permalink Normal View History

2023-11-26 00:39:54 +01:00
2024-07-22 18:06:12 +02:00
<p align="center">
<a href="https://versia.pub"><img src="https://cdn.versia.pub/branding/logo-dark.svg" alt="Versia Logo" height="110"></a>
2024-07-22 18:06:12 +02:00
</p>
2023-11-26 00:39:54 +01:00
2024-07-22 18:06:12 +02:00
<h2 align="center">
<strong><code>Versia Documentation</code></strong>
2024-07-22 18:06:12 +02:00
</h2>
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
<div align="center">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons/typescript/typescript-original.svg" height="42" width="52" alt="TypeScript logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/react/react-original.svg" height="42" width="52" alt="React logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/nextjs/nextjs-original.svg" height="42" width="52" alt="NextJS logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/docker/docker-original.svg" height="42" width="52" alt="Docker logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/bun/bun-original.svg" height="42" width="52" alt="Bun logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/css3/css3-original.svg" height="42" width="52" alt="CSS3 logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/html5/html5-original.svg" height="42" width="52" alt="HTML5 logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/linux/linux-original.svg" height="42" width="52" alt="Linux logo">
<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/tailwindcss/tailwindcss-original.svg" height="42" width="52" alt="TailwindCSS logo">
</div>
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
<br/>
<p align="center">
<img src="public/screenshots/framed/ipad-home.webp" alt="Versia on an iPad" height="400">
2024-07-22 18:06:12 +02:00
</p>
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
## Technologies
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
- [**`TypeScript`**](https://www.typescriptlang.org/): A typed superset of JavaScript that compiles to plain JavaScript.
- [**`React`**](https://reactjs.org/): A JavaScript library for building user interfaces.
- [**`Next.js`**](https://nextjs.org/): A React framework for building static and dynamic websites.
- [**`MDX`**](https://mdxjs.com/): Markdown for the component era.
- [**`Zustand`**](https://zustand.surge.sh/): A small, fast, and scalable state management library.
- [**`Framer Motion`**](https://www.framer.com/motion/): A production-ready motion library for React.
- [**`FlexSearch`**](https://flexsearch.net/): A full-text search library for JavaScript.
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
## Installation
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
This project uses [Bun](https://bun.sh) as a package manager. To install the dependencies, run:
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
```bash
bun install
```
To start the development server, run:
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
```bash
bun dev
```
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
## Contributing
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
Contributions are welcome! Feel free to open an issue or submit a pull request.
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
### Licenses
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
The code in this repository is licensed under the [MIT License](
https://opensource.org/licenses/MIT).
2024-07-22 11:49:47 +02:00
2024-07-22 18:06:12 +02:00
However, the *documentation text* (including the Markdown files in the `app` directory) is licensed under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/). You are free to share and adapt the text as long as you provide proper attribution.