edit readme
Docker Build / publish (push) Successful in 27m8s Details

main
Lea 2024-01-24 21:49:56 +01:00
parent 9b4eb8fcc6
commit 698f0b9052
Signed by: Lea
GPG Key ID: 1BAFFE8347019C42
6 changed files with 23 additions and 26 deletions

BIN
.assets/aliases.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

BIN
.assets/audit.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 166 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 316 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 299 KiB

BIN
.assets/users.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 172 KiB

View File

@ -1,39 +1,36 @@
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
# Maddy Admin Panel
## Getting Started
A front-end for [Maddy](https://maddy.email), allowing users to manage their account and administrators to manage the server.
First, run the development server:
<details>
<summary>Screenshots</summary>
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```
## Self-Service account management
<img src=".assets/self-service-dark.png" /> <img src=".assets/self-service-light.png" />
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## Administration
### Aliases
<img src=".assets/aliases.png" />
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
### Users
<img src=".assets/users.png" />
This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
### Audit Log
<img src=".assets/audit.png" />
## Learn More
</details>
To learn more about Next.js, take a look at the following resources:
## Features
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
- **Password management** - Users can easily update their account password
- **Aliases** - Users can create and manage their own aliases
- Normal aliases allow the user to freely choose their alias address from a list of domains. An administrator needs to approve the alias before it can be used.
- Temporary aliases are randomly generated and can be created by users without administrator approval. It's like a tempmail service, but cooler!
- **Administration** - Admins can easily perform common tasks
- Creating users, <s>deleting users and resetting their password</s> (todo)
- Creating and deleting aliases for any user
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
## Deploy on Vercel
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
Authentication is handled using the same authentication that Maddy uses, so users can use the same password to access their email and the Admin Panel.
### notes to add later
```sql