postiz/apps/docs/introduction.mdx

54 lines
1.8 KiB
Plaintext

---
title: Introduction
description: 'Welcome to crosspublic documentation'
---
<div className="w-full flex justify-center rounded-full">
<img
className="block dark:hidden"
src="/logo/light.png"
alt="Hero Light"
/>
<img
className="hidden dark:block"
src="/logo/dark.png"
alt="Hero Dark"
/>
</div>
## What is crosspublic?
crosspublic is a tool to convert private communication into public knowledge.<br />
Most of your users are not on your communication channels, and they are not aware of the questions that have already been asked and answered.<br />
## Architecture
crosspublic is an [NX monorepo](https://nx.dev) that contains the backend, control panel, discord bot, marketing website and the docs.<br /><br />
Unlike other NX project, this project has one `.env` file that is shared between all the apps.<br />
It makes it easier to develop and deploy the project.<br /><br />
When deploying to websites like [Railway](https://railway.app) or [Heroku](https://heroku.com), you can use a shared environment variables for all the apps.<br />
**It has four main components:**
- `Panel` - NextJS control panel to manage your FAQ, it also contains the public website of every user FAQ page.
- `Tenants` - NextJS website that contains the FAQ of every end-user.
- `Backend` - NestJS that operate as the server for both the bots and the website.
- `Discord` - Discord bot that listen to messages, and send them to the backend.
In the future there will also be a bot of Slack, Intercom, Telegram, and more.
<CardGroup cols={2}>
<Card
title="Quick start"
icon="pen-to-square"
href="/quickstart"
>
Learn how to install the project and start using it
</Card>
<Card
title="How it works"
icon="screwdriver-wrench"
href="/howitworks"
>
Learn the architecture of the project
</Card>
</CardGroup>