Add static build output

Author: cklei-carly

.github/workflows/deploy.yml

@@ -17,57 +17,26 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  build:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "24.1.0"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
       - name: Setup Pages
-        id: pages
         uses: actions/configure-pages@v4
-        with:
-          static_site_generator: other
-
-
-
-      - name: Build with Next.js
-        run: npm run build
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NEXT_PUBLIC_SITE_URL: ${{ steps.pages.outputs.base_url }}
-          NEXT_PUBLIC_BASE_PATH: ${{ steps.pages.outputs.base_path }}
-          NEXT_STATIC_EXPORT: "true"
-          NODE_ENV: "production"
-
-      - name: Verify output directory
-        run: |
-          if [ ! -d "./out" ]; then
-            echo "Error: Output directory './out' does not exist."
-            exit 1
-          fi
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
           path: ./out
 
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

.gitignore

@@ -5,7 +5,7 @@
 .contentlayer
 .content-collections
 .source
-/content/docs/
+
 
 # cache
 .cache/
@@ -15,7 +15,6 @@
 /fi-plugins/
 /fi-plugins*/
 /.next/
-/out/
 /build
 *.tsbuildinfo
 

README.md

@@ -30,9 +30,57 @@ cd static-plugin-doc-site-3
 
 # Install dependencies
 npm install
+```
+
+### 2. Configuration (Rate Limit Fix)
+
+To avoid GitHub API rate limits (60 requests/hour for unauthenticated users vs 5000/hour with a token), create a `.env.local` file:
+
+1. Create a Personal Access Token (PAT) on GitHub: [Settings > Developer settings > PAT](https://github.com/settings/tokens) (No special scopes needed for public repos).
+2. Create `GITHUB_TOKEN` in `.env.local` file:
+   ```bash
+   GITHUB_TOKEN=your_token_here
+   ```
+
+### 3. Usage & Deployment
+
+#### Fetch Documentation
+
+This pulls the documentation MD/MDX files from the configured GitHub repositories.
+
+```bash
+# Online: Fetch fresh content from GitHub
+npm run fetch-docs
+
+# Offline/Cached: Use local cache only (no API calls)
+npm run fetch-docs:cache
+```
+
+#### Build & Deploy
+
+Since GitHub Actions may hit API limits easily, we recommend building locally and pushing the static site.
+
+1. **Build locally**: This generates the `out/` folder.
+   ```bash
+   npm run build
+   ```
+2. **Commit and Push**:
+   ```bash
+   git add out
+   git commit -m "Update docs and static build"
+   git push
+   ```
+   The GitHub Action will now automatically deploy the `out/` folder from your commit to GitHub Pages.
+
+# Install dependencies
+
+npm install
+
 # or
+
 pnpm install
-```
+
+````
 
 ### 2. Environment Setup (Optional)
 
@@ -41,7 +89,7 @@ Create a `.env.local` file in the root directory:
 ```env
 GITHUB_TOKEN=your_github_personal_access_token_here
 NEXT_PUBLIC_SITE_URL=http://localhost:3000
-```
+````
 
 #### Getting a GitHub Token
 

content/docs/_meta.json

@@ -0,0 +1,16 @@
+{
+  "title": "Plugins",
+  "pages": [
+    "filament-tree",
+    "filament-cms-website-plugin",
+    "filament-tab-plugin",
+    "filament-panzoom",
+    "filament-scaffold",
+    "simple-contact-form",
+    "filament-firewall",
+    "filament-translate-field",
+    "filament-field-group",
+    "filament-email-2fa",
+    "filament-access-management"
+  ]
+}

content/docs/filament-access-management/1.x/_meta.json

@@ -0,0 +1,6 @@
+{
+  "title": "Filament Access Management 1.x",
+  "pages": [
+    "overview"
+  ]
+}

content/docs/filament-access-management/1.x/overview.mdx

@@ -0,0 +1,195 @@
+---
+title: Overview
+description: Complete user and role management solution for Filament applications with permissions, roles, and access control features.
+lastUpdated: 2026-03-02T10:21:10.447Z
+---
+
+# filament-access-management
+
+[![Latest Version on Packagist](https://img.shields.io/packagist/v/solution-forest/filament-access-management.svg?style=flat-square)](https://packagist.org/packages/solution-forest/filament-access-management)
+[![Total Downloads](https://img.shields.io/packagist/dt/solution-forest/filament-access-management.svg?style=flat-square)](https://packagist.org/packages/solution-forest/filament-access-management)
+
+
+This is an authentication plugin for Filament Admin with Laravel-permission
+
+## Installation
+
+1. You can install the package via composer:
+    ```bash
+    composer require solution-forest/filament-access-management
+    ```
+    
+2. Add the necessary trait to your User model:
+
+    ```php
+
+    use SolutionForest\FilamentAccessManagement\Concerns\FilamentUserHelpers;
+
+    class User extends Authenticatable
+    {
+        use FilamentUserHelpers;
+    }
+    ```
+    
+3. **Clear your config cache**:
+   ```bash
+    php artisan optimize:clear
+    # or
+    php artisan config:clear
+   ```
+
+4. Then execute the following commands:
+   ```bash
+   php artisan filament-access-management:install
+   ```
+   If you don't already have a user named `admin`, this command creates a **Super Admin User** with the following credentials:
+
+    - Name: admin
+    - E-mail address: admin@("slug" pattern from config("app.name")).com
+    - Password: admin
+
+    You can also create the super admin user with:
+
+    ```bash
+
+    php artisan make:super-admin-user
+
+    ```
+
+5. In your config/app.php place this code in you providers section
+    ``` php
+    'providers' => [
+
+        ...
+
+        /*
+            * Package Service Providers...
+            */
+        \SolutionForest\FilamentAccessManagement\FilamentAuthServiceProvider::class,
+
+        ...
+
+    ],
+    ```
+    
+
+
+## Publish Configs, Views, Translations and Migrations
+
+You can publish the configs, views, translations and migrations with:
+
+```bash
+php artisan vendor:publish --tag="filament-access-management-config"
+
+php artisan vendor:publish --tag="filament-access-management-views"
+
+php artisan vendor:publish --tag="filament-access-management-translations"
+
+php artisan vendor:publish --tag="filament-access-management-migrations"
+```
+
+## Migration
+
+```bash
+php artisan migrate
+```
+
+## Usage
+
+Upon installation, "Menu", "Users", "Roles" and "Permissions" pages will be created. Each user have roles and each role have permissions.
+
+![image](https://user-images.githubusercontent.com/73818060/232434966-91ab94fe-620a-4894-8632-dbe5e535e5ae.png)
+
+Manage Menu:
+![image](https://user-images.githubusercontent.com/73818060/232438118-0b4089e7-4ff0-40b8-93b1-c6d4c089ef14.png)
+
+Manage Users and their roles:
+![image](https://user-images.githubusercontent.com/73818060/232437828-73039db1-8976-4a23-a14d-2943d9495a47.png)
+![image](https://user-images.githubusercontent.com/73818060/232437890-2db887e1-dcbb-4d96-b072-365720be66d7.png)
+
+Manage Roles and their permissions:
+![image](https://user-images.githubusercontent.com/73818060/232438496-002b56d6-db98-4672-82cc-efcfc06fba9e.png)
+![image](https://user-images.githubusercontent.com/73818060/232438548-29b655bc-d683-4924-90b7-6ba25991d7ff.png)
+
+Manage Permissions:
+![image](https://user-images.githubusercontent.com/73818060/232438632-e5d9a5e5-7ef5-4ca5-a330-37948acd9748.png)
+![image](https://user-images.githubusercontent.com/73818060/232438719-fc2bca0b-7233-4aae-bf87-9c1d8524e42d.png)
+
+
+
+Create super admin user:
+
+```bash
+
+php artisan make:super-admin-user
+
+```
+
+Check permission:
+```bash
+
+# Check by permission's name
+\SolutionForest\FilamentAccessManagement\Http\Auth\Permission::check($name)
+
+# Check by http_path
+\SolutionForest\FilamentAccessManagement\Http\Auth\Permission::checkPermission($path)
+
+```
+
+Get current user:
+``` bash
+
+\SolutionForest\FilamentAccessManagement\Facades\FilamentAuthenticate::user();
+
+```
+
+## Advance Usage
+
+In default, the menu created will co-exist with the original menu of filament. To override the original menu with the menu from this package, modify `/config/filament-access-management.php` as following:
+
+1. Set ```filament.navigation.enabled => true```
+
+``` php
+
+    'filament' => [
+        ...
+        'navigation' => [
+            /**
+             * Using db based filament navigation if true.
+             */
+            'enabled' => true,
+            /**
+             * Table name db based filament navigation.
+             */
+            'table_name' => 'filament_menu',
+            /**
+             * Filament Menu Model.
+             */
+            'model' => Models\Menu::class,
+        ]
+        ...
+    ]
+
+```
+
+## Changelog
+
+Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
+
+## Contributing
+
+Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
+
+## Security Vulnerabilities
+
+Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
+
+## Credits
+
+- [Carly](https://github.com/n/a)
+- [All Contributors](../../contributors)
+
+## License
+
+The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
+

content/docs/filament-access-management/2.x/_meta.json

@@ -0,0 +1,6 @@
+{
+  "title": "Filament Access Management 2.x",
+  "pages": [
+    "overview"
+  ]
+}