Fix readme image

This commit is contained in:
Julien Nahum 2024-08-11 12:29:15 +02:00
parent 7888990e84
commit 0040f785da
1 changed files with 85 additions and 65 deletions

View File

@ -1,10 +1,9 @@
# OpnForm # OpnForm
<p align="center"> <p align="center">
<img src="https://github.com/JhumanJ/OpnForm/blob/main/public/img/social-preview.jpg?raw=true"> <img src="https://github.com/JhumanJ/OpnForm/blob/main/client/public/img/social-preview.jpg?raw=true">
</p> </p>
<p align="center"> <p align="center">
<a href="https://github.com/JhumanJ/OpnForm/stargazers"><img src="https://img.shields.io/github/stars/JhumanJ/OpnForm" alt="Github Stars"></a> <a href="https://github.com/JhumanJ/OpnForm/stargazers"><img src="https://img.shields.io/github/stars/JhumanJ/OpnForm" alt="Github Stars"></a>
</a> </a>
@ -43,6 +42,7 @@
And much more! And much more!
## Bounties ## Bounties
Get paid for contributing to OpnForm! Here are our open bounties: Get paid for contributing to OpnForm! Here are our open bounties:
<a href="https://console.algora.io/org/OpnForm/bounties?status=open"> <a href="https://console.algora.io/org/OpnForm/bounties?status=open">
@ -71,24 +71,28 @@ It takes 1 minute to try out the builder for free. You'll have high availability
OpnForm can be easily set up using Docker. Pre-built images are available on Docker Hub, which is the recommended method for most users. OpnForm can be easily set up using Docker. Pre-built images are available on Docker Hub, which is the recommended method for most users.
#### Prerequisites #### Prerequisites
- Docker - Docker
- Docker Compose - Docker Compose
#### Quick Start #### Quick Start
1. Clone the repository: 1. Clone the repository:
``` ```
git clone https://github.com/JhumanJ/OpnForm.git git clone https://github.com/JhumanJ/OpnForm.git
cd OpnForm cd OpnForm
``` ```
2. Set up environment files: 2. Set up environment files:
``` ```
cp .env.docker .env cp .env.docker .env
cp client/.env.docker client/.env cp client/.env.docker client/.env
``` ```
3. Start the application: 3. Start the application:
``` ```
docker-compose up -d docker-compose up -d
``` ```
@ -113,6 +117,7 @@ OpnForm can be easily set up using Docker. Pre-built images are available on Doc
### Initial Login ### Initial Login
After installation, use these credentials to access the admin panel: After installation, use these credentials to access the admin panel:
- Email: `admin@opnform.com` - Email: `admin@opnform.com`
- Password: `password` - Password: `password`
@ -125,17 +130,20 @@ Note: Public registration is disabled in the self-hosted version. Use the admin
For development or customization, you can build the Docker images locally: For development or customization, you can build the Docker images locally:
1. Build the images: 1. Build the images:
``` ```
docker build -t opnform-ui:local -f docker/Dockerfile.client . docker build -t opnform-ui:local -f docker/Dockerfile.client .
docker build -t opnform-api:local -f docker/Dockerfile.api . docker build -t opnform-api:local -f docker/Dockerfile.api .
``` ```
2. Create a docker-compose override file: 2. Create a docker-compose override file:
``` ```
cp docker-compose.override.yml.example docker-compose.override.yml cp docker-compose.override.yml.example docker-compose.override.yml
``` ```
Edit the `docker-compose.override.yml` file to use your locally built images: Edit the `docker-compose.override.yml` file to use your locally built images:
```yaml ```yaml
services: services:
api: api:
@ -152,6 +160,7 @@ For development or customization, you can build the Docker images locally:
This method allows you to make changes to the source code and rebuild the images as needed. This method allows you to make changes to the source code and rebuild the images as needed.
### Using Laravel Valet ### Using Laravel Valet
This section explains how to get started locally with the project. It's most likely relevant if you're trying to work on the project. This section explains how to get started locally with the project. It's most likely relevant if you're trying to work on the project.
First, let's work with the codebase and its dependencies. First, let's work with the codebase and its dependencies.
@ -183,9 +192,18 @@ php artisan jwt:secret # and select yes!
# Creates DB schemas # Creates DB schemas
php artisan migrate php artisan migrate
``` ```
Now, create an S3 bucket (or equivalent). Create an IAM user with access to this bucket, fill the environment variables: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_DEFAULT_REGION`, `AWS_BUCKET`. In your AWS bucket permissions, add the following under "Cross-origin resource sharing (CORS)": Now, create an S3 bucket (or equivalent). Create an IAM user with access to this bucket, fill the environment variables: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_DEFAULT_REGION`, `AWS_BUCKET`. In your AWS bucket permissions, add the following under "Cross-origin resource sharing (CORS)":
```json ```json
[ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "PUT", "POST", "GET", "DELETE" ], "AllowedOrigins": [ "*" ], "ExposeHeaders": [] } ] [
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["PUT", "POST", "GET", "DELETE"],
"AllowedOrigins": ["*"],
"ExposeHeaders": []
}
]
``` ```
🎉 Done! Enjoy your personal OpnForm instance at: [http://opnform.test](http://opnform.test). 🎉 Done! Enjoy your personal OpnForm instance at: [http://opnform.test](http://opnform.test).
@ -197,14 +215,16 @@ Now, create an S3 bucket (or equivalent). Create an IAM user with access to this
## Tech Stack ## Tech Stack
OpnForm is a standard web application built with: OpnForm is a standard web application built with:
- [Laravel](https://laravel.com/) PHP framework - [Laravel](https://laravel.com/) PHP framework
- [NuxtJs](https://nuxt.com/) Front-end SSR framework - [NuxtJs](https://nuxt.com/) Front-end SSR framework
- [Vue.js 3](https://vuejs.org/) Front-end framework - [Vue.js 3](https://vuejs.org/) Front-end framework
- [TailwindCSS](https://tailwindcss.com/) - [TailwindCSS](https://tailwindcss.com/)
## Contribute ## Contribute
You're more than welcome to contribute to this project. We don't have guidelines on this yet, but we will soon. In the meantime, feel free to ask [any question here](https://github.com/JhumanJ/OpnForm/discussions). You're more than welcome to contribute to this project. We don't have guidelines on this yet, but we will soon. In the meantime, feel free to ask [any question here](https://github.com/JhumanJ/OpnForm/discussions).
## License ## License
OpnForm is open-source under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. You can find it [here](https://github.com/JhumanJ/OpnForm/blob/main/LICENSE).
OpnForm is open-source under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. You can find it [here](https://github.com/JhumanJ/OpnForm/blob/main/LICENSE).