@skalfa/skalfa-app 1.0.0 → 1.0.2

package/.env.example

@@ -1,44 +1,44 @@
-# =========================>
-# ## Base configuration
-# =========================>
-NEXT_PUBLIC_APP_NAME="NEXT-LIGHT"
-NEXT_PUBLIC_DEBUG=false
-
-
-# =========================>
-# ## Api configuration
-# =========================>
-NEXT_PUBLIC_API_HOST="http://localhost:4000/api"
-NEXT_PUBLIC_STORAGE_HOST="http://localhost:4000/storage"
-NEXT_PUBLIC_API_HEADERS=""
-
-
-# =========================>
-# ## Socket configuration
-# =========================>
-NEXT_PUBLIC_SOCKET_HOST=""
-
-
-# =========================>
-# ## Cookie configuration
-# =========================>
-NEXT_PUBLIC_COOKIE_KEY=""
-
-
-# =========================>
-# ## Socket configuration
-# =========================>
-NEXT_PUBLIC_SOCKET_HOST=""
-NEXT_PUBLIC_SOCKET_KEY=""
-
-
-# =========================>
-# ## Map configuration
-# =========================>
-NEXT_PUBLIC_MAP_KEY="";
-
-
-# =========================>
-# ## Exposed port (when using docker)
-# =========================>
+# =========================>
+# ## Base configuration
+# =========================>
+NEXT_PUBLIC_APP_NAME="NEXT-LIGHT"
+NEXT_PUBLIC_DEBUG=false
+
+
+# =========================>
+# ## Api configuration
+# =========================>
+NEXT_PUBLIC_API_HOST="http://localhost:4000/api"
+NEXT_PUBLIC_STORAGE_HOST="http://localhost:4000/storage"
+NEXT_PUBLIC_API_HEADERS=""
+
+
+# =========================>
+# ## Socket configuration
+# =========================>
+NEXT_PUBLIC_SOCKET_HOST=""
+
+
+# =========================>
+# ## Cookie configuration
+# =========================>
+NEXT_PUBLIC_COOKIE_KEY=""
+
+
+# =========================>
+# ## Socket configuration
+# =========================>
+NEXT_PUBLIC_SOCKET_HOST=""
+NEXT_PUBLIC_SOCKET_KEY=""
+
+
+# =========================>
+# ## Map configuration
+# =========================>
+NEXT_PUBLIC_MAP_KEY="";
+
+
+# =========================>
+# ## Exposed port (when using docker)
+# =========================>
 NEXT_PUBLIC_PORT=3000

package/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+      - master
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Publish if version bumped
+        run: |
+          LOCAL_VER=$(node -p "require('./package.json').version")
+          NPM_VER=$(npm view @skalfa/skalfa-app version 2>/dev/null || echo "0.0.0")
+          if [ "$LOCAL_VER" != "$NPM_VER" ]; then
+            echo "Publishing @skalfa/skalfa-app $LOCAL_VER (Registry version: $NPM_VER)"
+            bun install
+            npm publish --access public
+          else
+            echo "@skalfa/skalfa-app is up to date ($LOCAL_VER)"
+          fi
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contributing to @skalfa/skalfa-app
+
+Thank you for your interest in contributing to Skalfa! We welcome contributions from the community to help make Skalfa the premier development framework.
+
+## How to Contribute
+
+To contribute to this package, please follow these standard open-source steps:
+
+### 1. Fork the Repository
+Fork the official Skalfa repository on GitHub to your personal account.
+
+### 2. Clone Your Fork
+Clone your personal fork to your local machine:
+```bash
+git clone https://github.com/your-username/skalfa.git
+cd skalfa
+```
+
+### 3. Create a Feature Branch
+Create a new branch for your feature or bugfix:
+```bash
+git checkout -b feature/amazing-new-feature
+```
+*(Use `bugfix/issue-description` for bugfixes).*
+
+### 4. Implement and Commit Your Changes
+Make your changes in the codebase. Write clean, formatted code and ensure all tests and typechecks pass. Commit your changes using semantic commit messages:
+```bash
+git commit -m "feat: add amazing new feature"
+```
+*(Use `fix: description` for bugfixes, and `docs: description` for documentation updates).*
+
+### 5. Push to GitHub
+Push your branch to your personal fork on GitHub:
+```bash
+git push origin feature/amazing-new-feature
+```
+
+### 6. Submit a Pull Request (PR)
+Go to the official Skalfa repository on GitHub. You will see a prompt to submit a pull request. Click "New Pull Request", describe your changes in detail, link any related issues, and submit it for review by the maintainers.
+
+## Guidelines
+* **Code Style**: Ensure your code conforms to the project's ESLint rules and formatting guidelines.
+* **Type Safety**: Write strict, type-safe TypeScript. Do not bypass the compiler.
+* **Testing**: Run local tests and verify that the build compiles with 0 errors before submitting a PR.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skalfa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,28 +1,91 @@
-# NEXT LIGHT V.3
-
-This is not a framework or pacakage for react js, but a starter template to start developing your website app using next js and several packages already installed in it (including tailwind css)
-
-## Documentation
-
-Find out and learn about Next-Light in the [Next-Light Documentation](https://light.sejedigital.com/next)
-
-## Features
-
-- Beautiful and powerful components available
-- Components made easy to modify
-- API Helpers
-- ETC
-
-## Instalations
-
-### yarn
-
-```
-yarn install && yarn run dev
-```
-
-### npm
-
-```
-npm install && npm run dev
-```
+<p align="center">
+  <img src="https://skalfa.sejedigital.com/images/logo-skalfa.png" alt="Skalfa Logo" width="300" />
+</p>
+
+# @skalfa/skalfa-app
+
+> Modern frontend starter template built with Next.js, pre-configured with PWA, Tauri, and modular extensions.
+
+---
+
+## About this Package
+
+This package is part of the **Skalfa Framework**, a premium development ecosystem designed to build high-performance, modular web applications and APIs.
+
+---
+
+## Documentation
+
+See the usage documentation at [Documentation](https://skalfa.sejedigital.com).
+
+---
+
+## Installation
+
+You can install this package using your preferred package manager:
+
+```bash
+# Using npm
+npm install @skalfa/skalfa-app
+
+# Using bun
+bun add @skalfa/skalfa-app
+```
+
+---
+
+## Development, Testing & Production Scripts
+
+This frontend starter template provides the following CLI execution scripts:
+
+### 💻 Development
+* **`bun run dev`**: Starts the Next.js development server in hot-reload mode.
+
+### 📦 Build & Production
+* **`bun run build`**: Compiles the Next.js application into optimized production build outputs (or static files if Tauri mode is triggered).
+* **`bun run start`**: Starts the Next.js production server.
+
+### 🧪 Verification & Linting
+* **`bun run test`**: Performs a strict, project-wide TypeScript compilation check (`tsc --noEmit`) to ensure type-safety.
+* **`bun run lint`**: Runs ESLint to analyze and format the source code.
+
+### 🖥️ Tauri Desktop & Mobile (Optional Extensions)
+* **`bun run tauri dev`**: Runs the Tauri desktop application wrapper in development mode.
+* **`bun run tauri build`**: Builds and packages the Tauri desktop application installer.
+* **`bun run tauri:android`**: Runs the Tauri application in an Android emulator.
+* **`bun run tauri:ios`**: Runs the Tauri application in an iOS simulator.
+
+---
+
+## Pre-installed Dependencies
+
+The following key dependencies are packaged and managed within this project:
+
+| Dependency | Scope | Version |
+| :--- | :--- | :--- |
+| `@fortawesome/fontawesome-svg-core` | runtime | `^6.7.2` |
+| `@fortawesome/free-brands-svg-icons` | runtime | `^6.7.2` |
+| `@fortawesome/free-regular-svg-icons` | runtime | `^6.7.2` |
+| `@fortawesome/free-solid-svg-icons` | runtime | `^6.7.2` |
+| `@fortawesome/react-fontawesome` | runtime | `^0.2.2` |
+| `@react-google-maps/api` | runtime | `^2.20.7` |
+| `@skalfa/skalfa-app-core` | runtime | `^1.0.0` |
+| `@tailwindcss/postcss` | runtime | `^4.0.0` |
+| `axios` | runtime | `^1.12.0` |
+| `moment` | runtime | `^2.30.1` |
+| `next` | runtime | `16.1.1` |
+| `postcss` | runtime | `^8.5.1` |
+| `react` | runtime | `^19.2.1` |
+| `react-dom` | runtime | `^19.2.1` |
+| `tailwindcss` | runtime | `^4.0.0` |
+| `@types/node` | development | `^20` |
+| `@types/react` | development | `^19.0.0` |
+| `@types/react-dom` | development | `^19.0.0` |
+| `eslint` | development | `^9.19.0` |
+| `typescript` | development | `^6.0.3` |
+
+---
+
+## License
+
+This package is licensed under the **MIT License**. For full license text, see the [LICENSE](LICENSE) file.

package/app/auth/edit/page.tsx

@@ -1,65 +1,65 @@
-"use client"
-
-import { useRouter } from "next/navigation";
-import { useAuthContext } from "@contexts";
-import { ButtonComponent, CardComponent, FormSupervisionComponent } from "@components";
-
-export default function EditProfile() {
-  const router    =  useRouter();
-  const { user }  =  useAuthContext();
-
-  return (
-    <>
-      <div className="h-screen flex flex-col justify-center items-center">
-        <h1 className="text-2xl font-extrabold italic">WELCOME TO NEXT-LIGHT v.3</h1>
-        <p className="text-sm font-semibold mt-6">Edit account!</p>
-
-        <CardComponent className="mt-4 p-6 w-[400px] rounded-2xl">
-          <FormSupervisionComponent 
-            fields={[
-              {
-                construction: {
-                  name: "name",
-                  label: "Nama",
-                  placeholder: "Ex: Joko Gunawan",
-                }
-              },
-              {
-                construction: {
-                  name: "email",
-                  label: "E-mail",
-                  placeholder: "Ex: example@mail.com",
-                }
-              },
-              {
-                construction: {
-                  type: "file",
-                  name: "image",
-                  label: "Picture",
-                }
-              },
-            ]}
-            defaultValue={user}
-            submitControl={{
-              path: "me/update"
-            }}
-            onSuccess={() => {
-              router.push("/auth/me")
-            }}
-            footerControl={({loading}) => (
-              <>
-                <ButtonComponent
-                  type="submit"
-                  label="Save Changes"
-                  block
-                  className="mt-4"
-                  loading={loading}
-                />
-              </>
-            )}
-          />
-        </CardComponent>
-      </div>
-    </>
-  );
-}
+"use client"
+
+import { useRouter } from "next/navigation";
+import { useAuthContext } from "@contexts";
+import { ButtonComponent, CardComponent, FormSupervisionComponent } from "@components";
+
+export default function EditProfile() {
+  const router    =  useRouter();
+  const { user }  =  useAuthContext();
+
+  return (
+    <>
+      <div className="h-screen flex flex-col justify-center items-center">
+        <h1 className="text-2xl font-extrabold italic">WELCOME TO NEXT-LIGHT v.3</h1>
+        <p className="text-sm font-semibold mt-6">Edit account!</p>
+
+        <CardComponent className="mt-4 p-6 w-[400px] rounded-2xl">
+          <FormSupervisionComponent 
+            fields={[
+              {
+                construction: {
+                  name: "name",
+                  label: "Nama",
+                  placeholder: "Ex: Joko Gunawan",
+                }
+              },
+              {
+                construction: {
+                  name: "email",
+                  label: "E-mail",
+                  placeholder: "Ex: example@mail.com",
+                }
+              },
+              {
+                construction: {
+                  type: "file",
+                  name: "image",
+                  label: "Picture",
+                }
+              },
+            ]}
+            defaultValue={user}
+            submitControl={{
+              path: "me/update"
+            }}
+            onSuccess={() => {
+              router.push("/auth/me")
+            }}
+            footerControl={({loading}) => (
+              <>
+                <ButtonComponent
+                  type="submit"
+                  label="Save Changes"
+                  block
+                  className="mt-4"
+                  loading={loading}
+                />
+              </>
+            )}
+          />
+        </CardComponent>
+      </div>
+    </>
+  );
+}

package/app/auth/login/page.tsx

@@ -1,63 +1,63 @@
-"use client"
-
-import { useRouter } from "next/navigation";
-import { ButtonComponent, CardComponent, FormSupervisionComponent } from "@components";
-import { useAuthContext } from "@contexts";
-import Link from "next/link";
-
-export default function Login() {
-  const router = useRouter();
-  const {setAccessToken,setUser} = useAuthContext();
-
-  return (
-    <>
-      <div className="h-screen flex flex-col justify-center items-center">
-        <h1 className="text-2xl font-extrabold italic">WELCOME TO NEXT-LIGHT v.3</h1>
-        <p className="text-sm font-semibold mt-6">Sign in with your account!</p>
-
-        <CardComponent className="mt-4 p-6 w-[400px] rounded-2xl">
-          <FormSupervisionComponent
-            fields={[
-              {
-                construction: {
-                  name: "email",
-                  label: "E-mail",
-                  placeholder: "Ex: example@mail.com",
-                  validations: "required|min:10|max:50|email"
-                }
-              },
-              {
-                construction: {
-                  type: "password",
-                  name: "password",
-                  label: "Password",
-                  placeholder: "Ex: secret123",
-                }
-              }
-            ]}
-            submitControl={{
-              path: "login"
-            }}
-            onSuccess={(res) => {
-              setAccessToken(res?.data?.token)
-              setUser(res?.data?.user)
-              router.push("/auth/me")
-            }}
-            footerControl={() => (
-              <>
-                <ButtonComponent
-                  type="submit"
-                  label="Login Now"
-                  block
-                  className="mt-4"
-                />
-
-                <p className="mt-4 text-center">Don&apos;t have an account yet? <Link href="/auth/register" className="text-primary underline">Create Account</Link></p>
-              </>
-            )}
-          />
-        </CardComponent>
-      </div>
-    </>
-  );
-}
+"use client"
+
+import { useRouter } from "next/navigation";
+import { ButtonComponent, CardComponent, FormSupervisionComponent } from "@components";
+import { useAuthContext } from "@contexts";
+import Link from "next/link";
+
+export default function Login() {
+  const router = useRouter();
+  const {setAccessToken,setUser} = useAuthContext();
+
+  return (
+    <>
+      <div className="h-screen flex flex-col justify-center items-center">
+        <h1 className="text-2xl font-extrabold italic">WELCOME TO NEXT-LIGHT v.3</h1>
+        <p className="text-sm font-semibold mt-6">Sign in with your account!</p>
+
+        <CardComponent className="mt-4 p-6 w-[400px] rounded-2xl">
+          <FormSupervisionComponent
+            fields={[
+              {
+                construction: {
+                  name: "email",
+                  label: "E-mail",
+                  placeholder: "Ex: example@mail.com",
+                  validations: "required|min:10|max:50|email"
+                }
+              },
+              {
+                construction: {
+                  type: "password",
+                  name: "password",
+                  label: "Password",
+                  placeholder: "Ex: secret123",
+                }
+              }
+            ]}
+            submitControl={{
+              path: "login"
+            }}
+            onSuccess={(res) => {
+              setAccessToken(res?.data?.token)
+              setUser(res?.data?.user)
+              router.push("/auth/me")
+            }}
+            footerControl={() => (
+              <>
+                <ButtonComponent
+                  type="submit"
+                  label="Login Now"
+                  block
+                  className="mt-4"
+                />
+
+                <p className="mt-4 text-center">Don&apos;t have an account yet? <Link href="/auth/register" className="text-primary underline">Create Account</Link></p>
+              </>
+            )}
+          />
+        </CardComponent>
+      </div>
+    </>
+  );
+}