@launch77-shared/app-template-webapp 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @launch77-shared/app-template-webapp
+
+## 1.1.0
+
+### Minor Changes
+
+- 5a6a23f: updated the directory structure for webapps to now start with /src.

package/README.md.hbs

@@ -40,13 +40,46 @@ This app uses the following Launch77 platform packages:
 
 ## Project Structure
 
+This template follows the industry-standard `/src` directory structure for Next.js applications:
+
+```
+src/
+├── app/                    # Next.js App Router (pages, layouts, routes)
+│   ├── layout.tsx         # Root layout
+│   ├── page.tsx           # Homepage
+│   ├── globals.css        # Global styles
+│   ├── dashboard/         # Example dashboard page
+│   └── about/             # About page
+├── components/            # Shared React components
+│   └── ui/               # UI component library (shadcn-compatible)
+├── lib/                  # Utility functions and libraries
+├── hooks/                # Custom React hooks
+└── modules/              # Plugin-installed feature modules
+    └── (plugin modules installed here)
+
+public/                    # Static assets
 ```
-app/
-├── layout.tsx       # Root layout
-├── page.tsx         # Homepage
-├── dashboard/       # Example dashboard page
-├── about/           # About page
-└── globals.css      # Global styles (imports @launch77/theme)
+
+### Directory Conventions
+
+- **`src/app/`** - Next.js App Router pages and layouts only. Keep routing logic here.
+- **`src/components/`** - Create all shared components here. Use `@/components` to import.
+- **`src/lib/`** - Utility functions, helpers, API clients. Use `@/lib` to import.
+- **`src/hooks/`** - Custom React hooks. Use `@/hooks` to import.
+- **`src/modules/`** - Feature modules installed by Launch77 plugins.
+
+### Creating Components
+
+Place shared components in `src/components/`:
+
+```tsx
+// src/components/Button.tsx
+export function Button() {
+  return <button className="bg-primary">Click me</button>
+}
+
+// src/app/page.tsx
+import { Button } from '@/components/Button'
 ```
 
 ## Next Steps

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launch77-shared/app-template-webapp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Launch77 webapp app template",
   "type": "module",
   "main": "index.js",

package/src/components/.gitkeep

@@ -0,0 +1,2 @@
+# This directory contains shared React components
+# Use @/components to import from here

package/src/hooks/.gitkeep

@@ -0,0 +1,2 @@
+# This directory contains custom React hooks
+# Use @/hooks to import from here

package/src/lib/.gitkeep

@@ -0,0 +1,2 @@
+# This directory contains utility functions, helpers, and libraries
+# Use @/lib to import from here

package/tailwind.config.ts

@@ -1,7 +1,9 @@
 import type { Config } from 'tailwindcss'
 
 const config: Config = {
-  content: ['./app/**/*.{js,ts,jsx,tsx,mdx}', './components/**/*.{js,ts,jsx,tsx,mdx}', './lib/**/*.{js,ts,jsx,tsx,mdx}'],
+  content: [
+    './src/**/*.{js,ts,jsx,tsx,mdx}', // All source code including /src/app, /src/components, etc.
+  ],
   theme: {
     extend: {
       // Add your custom theme extensions here

package/template.json

@@ -0,0 +1 @@
+{}

package/tsconfig.json

@@ -20,7 +20,7 @@
       }
     ],
     "paths": {
-      "@/*": ["./*"]
+      "@/*": ["./src/*"]
     },
     "baseUrl": "."
   },