0
Fork 0
mirror of https://github.com/penpot/penpot-helm.git synced 2024-12-22 13:43:01 -05:00

docs: update README.md

This commit is contained in:
David Barragán Merino 2024-07-23 18:10:40 +02:00
parent 7a3b1534c1
commit f1bf37740b
2 changed files with 94 additions and 35 deletions

View file

@ -3,50 +3,64 @@
# Penpot Helm Chart # Penpot Helm Chart
This repository contains the Penpot Helm Chart curated by Penpot. This repository contains charts for Penpot (https://penpot.app) project.
## Local Development
### Requirements: ## What is Penpot
- [docker](https://docs.docker.com/engine/install/) Penpot is the first **open-source** design tool for design and code collaboration. Designers can create stunning designs, interactive prototypes, design systems at scale, while developers enjoy ready-to-use code and make their workflow easy and fast. And all of this with no handoff drama.
- [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)
- [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
- [helm](https://helm.sh/docs/intro/install/)
- [helm-doc](https://github.com/norwoodj/helm-docs/tree/master)
- [pre-commit](https://pre-commit.com/)
### Set the environment: Penpot is available on browser and [self host](https://penpot.app/self-host). Its web-based and works with open standards (SVG, CSS and HTML). And last but not least, its free!
```shell
# Enable precommit in the repository ## Usage
pre-commit install --install-hooks -f
The charts can be added using following command:
```
helm repo add argo https://helm.penpot.app/
``` ```
### Usage: ## Contributing ##
- Create the cluster `penpot-cluster` with a namespace `penpot`: We'd love to have you contribute! Please refer to our [contribution guidelines](/CONTRIBUTING.md) for details if you want to contribute to this repository or visit the [Contributing](https://github.com/penpot/penpot/tree/develop?tab=readme-ov-file#contributing) section in the main project repository to discover other ways to contribute.
```shell
./scripts/cluster_create.sh
```
- Download dependencies
```shell
helm repo add bitnami https://charts.bitnami.com/bitnami
helm dependency build ./charts/penpot
```
- Install the chart ## Community
```shell
helm install penpot ./charts/penpot -f devel/penpot.values.yaml
```
- Access to [http://penpot.example.com/](http://penpot.example.com/) ( We love the Open Source software community. Contributing is our passion and if its yours too, participate and [improve](https://community.penpot.app/c/help-us-improve-penpot/7) Penpot. All your designs, code and ideas are welcome!
> [!NOTE]
> You need to add `127.0.1.1 penpot.example.com` to `/etc/hosts`
> [!TIP] If you need help or have any questions; if youd like to share your experience using Penpot or get inspired; if youd rather meet our community of developers and designers, [join our Community](https://community.penpot.app/)!
> if you disable ingress, you can exposing the app in the port 8888 with:
> ```shell You will find the following categories:
> kubectl port-forward service/penpot 8888:80 - [Ask the Community](https://community.penpot.app/c/ask-for-help-using-penpot/6)
> ``` - [Troubleshooting](https://community.penpot.app/c/technical/8)
- [Help us Improve Penpot](https://community.penpot.app/c/help-us-improve-penpot/7)
- [#MadeWithPenpot](https://community.penpot.app/c/madewithpenpot/9)
- [Events and Announcements](https://community.penpot.app/c/announcements/5)
- [Inside Penpot](https://community.penpot.app/c/inside-penpot/21)
- [Penpot in your language](https://community.penpot.app/c/penpot-in-your-language/12)
- [Design and Code Essentials](https://community.penpot.app/c/design-and-code-essentials/22)
## Resources
You can ask and answer questions, have open-ended conversations, and follow along on decisions affecting the project.
💾 [Documentation](https://help.penpot.app/technical-guide/)
🚀 [Getting Started](https://help.penpot.app/technical-guide/getting-started/)
✏️ [Tutorials](https://www.youtube.com/playlist?list=PLgcCPfOv5v54WpXhHmNO7T-YC7AE-SRsr)
🏘️ [Architecture](https://help.penpot.app/technical-guide/developer/architecture/)
📚 [Dev Diaries](https://penpot.app/dev-diaries.html)
## License ##
```
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/.
Copyright (c) KALEIDOS INC
```
Penpot is a Kaleidos [open source project](https://kaleidos.net/)

45
devel/README.md Normal file
View file

@ -0,0 +1,45 @@
# Penpot Helm Chart: Devel doc
### Requirements:
- [docker](https://docs.docker.com/engine/install/)
- [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)
- [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
- [helm](https://helm.sh/docs/intro/install/)
- [helm-doc](https://github.com/norwoodj/helm-docs/tree/master)
- [pre-commit](https://pre-commit.com/)
### Set the environment:
```shell
# Enable precommit in the repository
pre-commit install --install-hooks -f
```
### Usage:
- Create the cluster `penpot-cluster` with a namespace `penpot`:
```shell
./scripts/cluster_create.sh
```
- Download dependencies
```shell
helm repo add bitnami https://charts.bitnami.com/bitnami
helm dependency build ./charts/penpot
```
- Install the chart
```shell
helm install penpot ./charts/penpot -f devel/penpot.values.yaml
```
- Access to [http://penpot.example.com/](http://penpot.example.com/) (
> [!NOTE]
> You need to add `127.0.1.1 penpot.example.com` to `/etc/hosts`
> [!TIP]
> if you disable ingress, you can exposing the app in the port 8888 with:
> ```shell
> kubectl port-forward service/penpot 8888:80
> ```