Merge branch 'main' of github.com:devforth/adminforth

Author: NoOne7135

README.md

@@ -37,31 +37,43 @@ Why AdminForth:
 
 ## Project initialisation
 
-```
+To create an AdminForth project, run:
+
+```bash
 npx adminforth create-app
 ```
 
-## Previews
+During the interactive initialization process, AdminForth will ask you to provide a local database URL.
 
-<a href="https://adminforth.dev/docs/tutorial/Customization/customPages">Custom Dashboard</a>
-<br/>
-<img src="https://github.com/user-attachments/assets/aa899196-f7f3-4582-839c-2267f2e9e197" alt="AdminForth Dashboard demo" width="80%" />
+### Integrating AdminForth into your existing application
 
-<a href="https://adminforth.dev/docs/tutorial/Plugins/chat-gpt">Text completion plugin (Copilot-style) using LLMs</a>
-<br/>
+If you want to build an admin panel for an existing project that already has a database with tables, you can provide the connection URL to your existing development database, such as a local or deployed one.
 
-<img src="https://github.com/user-attachments/assets/cfa17cbd-3a53-4725-ab46-53c7c7666028" alt="AdminForth ChatGPT demo" width="80%" />
+After that, you may want to generate AdminForth resource files from your existing database tables:
 
-<a href="https://adminforth.dev/docs/tutorial/Plugins/upload/#image-generation">Image Generation using image generation models</a>
-<br/>
-<img src="https://github.com/user-attachments/assets/b923e044-7e29-46ff-ab91-eeca5eee2b0a" alt="AdminForth DALE-E image generator demo" width="80%">
+```bash
+npx adminforth resource
+```
+
+Resource files are needed for AdminForth to “know” about your tables and define how to work with them.
+
+Use the command above every time you add new tables or change their schema.
+
+### Starting from scratch
+
+If you do not have a database yet, start an empty local database, for example PostgreSQL in Docker, and provide its URL to the AdminForth CLI.
+
+If the adminforth CLI does not detect any tables, it will suggest adding Prisma as a migration tool. Prisma is not related to AdminForth, but it is one of the most convenient migration tools.
+
+Please follow [getting started](https://adminforth.dev/docs/tutorial/gettingStarted/).
 
+# For AdminForth developers
 
-# For developers
+> Follow this section only if you want to make changes to the AdminForth framework or develop a plugin.
 
-The most convenient way to add new features or fixes is using `dev-demo`. It imports the source code of the repository and plugins so you can edit them and see changes on the fly.
+The most convenient way to add new features or fixes is to use `dev-demo`. It imports the repository source code and plugins, so you can edit them and see changes on the fly.
 
-# Requirements
+## Requirements
 
 - **Node.js 20**
 - **Docker**

adminforth/documentation/blog/2025-11-04-k3s-ec2-deployment/index.md

@@ -729,13 +729,14 @@ sed -i 's/certificate-authority-data:.*/insecure-skip-tls-verify: true/g' kubeco
 export KUBECONFIG=$(pwd)/kubeconfig.yaml
 
 cd helm
-export APP_NAMESPACE="myadmin"
-export IMAGE_FULL_TAG="$${ACCOUNT_ID}.dkr.ecr.$${REGION}.amazonaws.com/myadmink3s:$${TAG}"
+export APP_NAMESPACE="myadmin"  # <<< SET YOUR APP NAMESPACE HERE
+export IMAGE_FULL_TAG="$${ACCOUNT_ID}.dkr.ecr.$${REGION}.amazonaws.com/myadmink3s:$${TAG}"  # Change 'myadmink3s' to your app name in 'helmfile.yaml' & 'Chart.yaml' files as well
 helmfile apply
 cd ..
 
 echo "Deployment complete!"
 ```
+You need to change the values of `APP_NAMESPACE` and `IMAGE_FULL_TAG` in the `deploy/deploy.sh` script to match your application name and image tag. Note that `IMAGE_FULL_TAG` is constructed dynamically from the Terraform outputs and the tag, so you only need to change `APP_NAMESPACE`.
 
 Don't forget to make the script executable: