feat: Introduce module-based architecture for Remix fullstack projects, organizing features into dedicated modules with services and components.

Author: phuthuycoding

.github/workflows/ci.yml

@@ -19,19 +19,24 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 
       - name: Install dependencies
-        run: npm ci
+        run: bun install
 
       - name: Build TypeScript
-        run: npm run build
+        run: bun run build
 
       - name: Run tests
-        run: npm test
+        run: bun run test
 
       - name: Check CLI works
         run: |
@@ -48,17 +53,22 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: 20
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies
-        run: npm ci
+        run: bun install
 
       - name: Build TypeScript
-        run: npm run build
+        run: bun run build
 
       - name: Publish to npm
         run: npm publish --access public

.github/workflows/publish.yml

@@ -19,14 +19,19 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies
-        run: npm ci
+        run: bun install
 
       - name: Publish to NPM
         run: npm publish --provenance --access public

.gitignore

@@ -5,3 +5,5 @@ release/
 *.log
 .env
 .env.*
+
+package-lock.json

assets/architecture/laravel-backend.md

@@ -64,7 +64,7 @@ Request    Services (optional: cache, external APIs)
 app/Domain/
 ├── Story/
 │   ├── Entities/
-│   │   └── StoryDTO.php
+│   │   └── Story.php
 │   ├── Events/
 │   │   └── StoryCreated.php
 │   ├── Exceptions/
@@ -297,19 +297,7 @@ class GetStoryBySlugUseCaseTest extends TestCase
     }
 }
 ```
+# Documentation
 
-## Artisan Commands
-
-```bash
-# No built-in command for UseCase, create manually or use custom command
-php artisan make:controller Web/StoryController
-php artisan make:model Story -mfs
-php artisan make:request Story/StoreStoryRequest
-php artisan make:resource StoryResource
-php artisan make:event StoryCreated
-php artisan make:listener NotifyOnStoryCreated
-
-# Testing
-php artisan test
-php artisan test --filter=StoryTest
-```
+- When you create a new UseCase, make sure to document it in the project dir `docs/{domain}/{usecase}.md` file.
+- The usecase spectation documentation flow UML or Cockburn

assets/architecture/monorepo.md

@@ -32,21 +32,40 @@
 │   └── agents/
 ├── CLAUDE.md
 ├── package.json                    # Root package.json
-├── pnpm-workspace.yaml             # pnpm workspaces
+├── pnpm-workspace.yaml             # (If pnpm) Workspace config
 ├── turbo.json                      # Turborepo config
-├── docker-compose.yml
 └── README.md
 ```
 
+## Package Manager Selection
+
+**Ask the user to choose a package manager:**
+
+1.  **pnpm** (Recommended):
+    *   Uses `pnpm-workspace.yaml`.
+2.  **Bun** / **Yarn** / **NPM**:
+    *   Uses `workspaces` in `package.json`.
+
 ## Workspace Configuration
 
-### pnpm-workspace.yaml
+### Option 1: pnpm (pnpm-workspace.yaml)
 ```yaml
 packages:
   - 'apps/*'
   - 'packages/*'
 ```
 
+### Option 2: Bun / Yarn / NPM (package.json)
+Add to root `package.json`:
+```json
+{
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ]
+}
+```
+
 ### turbo.json
 ```json
 {
@@ -122,43 +141,7 @@ export function Button({ variant, children, onClick }: ButtonProps) {
 }
 ```
 
-## Docker Compose
 
-```yaml
-version: '3.8'
-services:
-  web:
-    build:
-      context: .
-      dockerfile: apps/web/Dockerfile
-    ports:
-      - "3000:3000"
-    depends_on:
-      - api
-
-  api:
-    build:
-      context: .
-      dockerfile: apps/api/Dockerfile
-    ports:
-      - "8080:8080"
-    environment:
-      - DATABASE_URL=postgres://user:pass@db:5432/app
-    depends_on:
-      - db
-
-  db:
-    image: postgres:15
-    environment:
-      POSTGRES_USER: user
-      POSTGRES_PASSWORD: pass
-      POSTGRES_DB: app
-    volumes:
-      - pgdata:/var/lib/postgresql/data
-
-volumes:
-  pgdata:
-```
 
 ## Conventions