spine-framework-portal 0.1.5 → 0.1.7

package/LICENSE.md

@@ -0,0 +1,13 @@
+# Spine Framework Internal Use License 1.0.0
+
+**Source-available. Free for internal use. Commercial rights reserved.**
+
+Copyright © 2026 Dahl Ventures Inc. All rights reserved.
+
+This software is licensed under the Spine Framework Internal Use License 1.0.0.
+
+For full license terms, see: https://github.com/spine-framework/spine-framework/blob/main/LICENSE.md
+
+**Summary:** You may use this software for internal business use only. Commercial use, resale, SaaS offering, white-labeling, and distribution require a separate Commercial License.
+
+Contact: webmaster@spine-framework.com

package/README.md

@@ -1,26 +1,58 @@
 # spine-framework-portal
 
-Customer self-service portal app for Spine Framework.
+**We're building Spine in the open.** The source is visible, the roadmap is public, and we share what we learn along the way. That said, Spine is not open source — commercial use requires a license. See [LICENSE.md](./LICENSE.md) for details.
+
+---
+
+Customer Portal is a self-service app for Spine Framework. It gives your customers a branded portal to submit and track support tickets, browse the knowledge base, access courses, and participate in community discussions.
+
+## Requirements
+
+- [Spine Framework](https://www.npmjs.com/package/spine-framework) `>=0.1.0`
+- A Spine project initialized with `npx spine-framework init`
 
 ## Installation
 
 ```bash
-npm install spine-framework-portal
+npx spine-framework install-app spine-framework-portal@latest
 ```
 
-## Usage
+This seeds the required roles, types, and configuration into your database and registers the app with Spine's navigation system.
+
+## Features
+
+- **Support tickets** — customers submit and track their own tickets
+- **Knowledge base** — self-service article browsing and search
+- **Courses** — lesson and course content delivery
+- **Community** — discussion threads and Q&A
+- **Marketplace** — app and integration discovery
+
+## Routes
+
+| Path | Description |
+|------|-------------|
+| `/portal` | Portal home |
+| `/portal/tickets` | Ticket list |
+| `/portal/tickets/:id` | Ticket detail |
+| `/portal/kb` | Knowledge base |
+| `/portal/courses` | Courses |
+| `/portal/community` | Community |
+| `/portal/marketplace` | Marketplace |
+
+## Uninstalling
 
 ```bash
-npx spine-framework install-app customer-portal
+npx spine-framework uninstall-app spine-framework-portal
 ```
 
-## Features
+## License
 
-- Community discussion and Q&A
-- Course and lesson content delivery
-- Support ticket submission and tracking
-- Knowledge base article access
+Spine Framework Portal is **source-available, free for internal use**. Commercial use requires a separate license.
 
-## License
+See [LICENSE.md](./LICENSE.md) for full terms.
+
+For commercial licensing: [spine-framework.com](https://spine-framework.com) · webmaster@spine-framework.com
+
+---
 
-MIT
+Copyright © 2026 Dahl Ventures Inc. All rights reserved.

package/components/PortalHeader.tsx

@@ -2,6 +2,7 @@ import { useState } from 'react'
 import { NavLink, useNavigate } from 'react-router-dom'
 import { Ticket, Users, BookOpen, GraduationCap, Store, LayoutGrid, User, LogOut, Save } from 'lucide-react'
 import { useAuth } from '@core/contexts/AuthContext'
+import { useCurrentApp } from '@core/contexts/AppContext'
 import { Button } from '@core/components/ui/button'
 import { Avatar, AvatarFallback } from '@core/components/ui/avatar'
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from '@core/components/ui/dialog'
@@ -10,19 +11,23 @@ import { Label } from '@core/components/ui/label'
 import { Separator } from '@core/components/ui/separator'
 
 const NAV_ITEMS = [
-  { label: 'Tickets',        path: '/portal/tickets',     icon: Ticket },
-  { label: 'Knowledge Base', path: '/portal/kb',          icon: BookOpen },
-  { label: 'Courses',        path: '/portal/courses',     icon: GraduationCap },
-  { label: 'Community',      path: '/portal/community',   icon: Users },
-  { label: 'Marketplace',    path: '/portal/marketplace', icon: Store },
+  { label: 'Tickets',        path: '/tickets',     icon: Ticket },
+  { label: 'Knowledge Base', path: '/kb',          icon: BookOpen },
+  { label: 'Courses',        path: '/courses',     icon: GraduationCap },
+  { label: 'Community',      path: '/community',   icon: Users },
+  { label: 'Marketplace',    path: '/marketplace', icon: Store },
 ]
 
 export function PortalHeader() {
   const { user, logout } = useAuth()
+  const app = useCurrentApp()
   const navigate = useNavigate()
   const [accountOpen, setAccountOpen] = useState(false)
   const [displayName, setDisplayName] = useState(user?.full_name || user?.email?.split('@')[0] || '')
 
+  // Normalize route_prefix: '/' → '' so paths are /, /tickets, /kb, etc.
+  const base = app.route_prefix === '/' ? '' : (app.route_prefix || '')
+
   const initials = (displayName || user?.email || 'U')
     .split(' ')
     .map((w: string) => w[0])
@@ -43,7 +48,7 @@ export function PortalHeader() {
     <>
       <header className="sticky top-0 z-50 bg-background border-b border-border shadow-sm">
         <div className="flex items-center h-14 px-6 gap-6">
-          <NavLink to="/portal" className="flex items-center gap-2 shrink-0 text-foreground hover:text-primary transition-colors">
+          <NavLink to={`${base}/`} className="flex items-center gap-2 shrink-0 text-foreground hover:text-primary transition-colors">
             <LayoutGrid size={18} className="text-primary" />
             <span className="font-semibold tracking-tight text-sm">Customer Portal</span>
           </NavLink>
@@ -52,7 +57,7 @@ export function PortalHeader() {
             {NAV_ITEMS.map(({ label, path, icon: Icon }) => (
               <NavLink
                 key={path}
-                to={path}
+                to={`${base}${path}`}
                 className={({ isActive }) =>
                   [
                     'flex items-center gap-1.5 px-3 py-1.5 rounded-md text-sm font-medium transition-colors',

package/index.tsx

@@ -1,9 +1,10 @@
 import { lazy, Suspense } from 'react'
-import { Routes, Route, Navigate } from 'react-router-dom'
+import { Routes, Route, Navigate, useLocation } from 'react-router-dom'
 import { LoadingSpinner } from '@core/components/ui/LoadingSpinner'
 import { TooltipProvider } from '@core/components/ui/tooltip'
 import { PortalHeader } from './components/PortalHeader'
 import { PortalFooter } from './components/PortalFooter'
+import { useCurrentApp } from '@core/contexts/AppContext'
 
 const HomePage = lazy(() => import('./pages/HomePage').then(m => ({ default: m.HomePage })))
 const TicketsPage = lazy(() => import('./pages/TicketsPage').then(m => ({ default: m.TicketsPage })))
@@ -13,6 +14,16 @@ const KnowledgePage = lazy(() => import('./pages/KnowledgePage').then(m => ({ de
 const MarketplacePage = lazy(() => import('./pages/MarketplacePage').then(m => ({ default: m.MarketplacePage })))
 
 function PortalLayout() {
+  const location = useLocation()
+  const app = useCurrentApp()
+
+  // Normalize route_prefix: '/' → '' so paths are /, /tickets, /kb, etc.
+  const base = app.route_prefix === '/' ? '' : (app.route_prefix || '')
+  const prefixDepth = base.split('/').filter(Boolean).length
+
+  const segments = location.pathname.split('/').filter(Boolean)
+  const appSegments = segments.slice(prefixDepth) // strips the prefix segments
+
   return (
     <div className="h-full flex flex-col bg-background overflow-hidden">
       <PortalHeader />
@@ -20,15 +31,15 @@ function PortalLayout() {
         <Suspense fallback={<div className="flex-1 flex items-center justify-center"><LoadingSpinner /></div>}>
           <div className="flex-1 flex flex-col min-h-0">
             <Routes>
-              <Route path="/" element={<HomePage />} />
-              <Route path="/tickets" element={<TicketsPage />} />
-              <Route path="/tickets/:id" element={<TicketsPage />} />
-              <Route path="/kb" element={<KnowledgePage />} />
-              <Route path="/knowledge" element={<Navigate to="/portal/kb" replace />} />
-              <Route path="/courses" element={<CoursesPage />} />
-              <Route path="/community" element={<CommunityPage />} />
-              <Route path="/marketplace" element={<MarketplacePage />} />
-              <Route path="*" element={<Navigate to="/portal" replace />} />
+              <Route index element={<HomePage />} />
+              <Route path="tickets" element={<TicketsPage />} />
+              <Route path="tickets/:id" element={<TicketsPage />} />
+              <Route path="kb" element={<KnowledgePage />} />
+              <Route path="knowledge" element={<Navigate to="kb" replace />} />
+              <Route path="courses" element={<CoursesPage />} />
+              <Route path="community" element={<CommunityPage />} />
+              <Route path="marketplace" element={<MarketplacePage />} />
+              <Route path="*" element={<Navigate to="/" replace />} />
             </Routes>
           </div>
         </Suspense>

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "spine-framework-portal",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Customer Portal — self-service portal app for Spine Framework",
   "type": "module",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
     "type": "git",
-    "url": "https://github.com/art-mojo-admin/spine",
+    "url": "https://github.com/spine-framework/portal",
     "directory": "custom/apps/customer-portal"
   },
   "peerDependencies": {
@@ -19,7 +19,8 @@
     "pages/",
     "components/",
     "functions/",
-    "README.md"
+    "README.md",
+    "LICENSE.md"
   ],
   "spine": {
     "type": "app",