create-nuxt-base 0.3.16 → 1.0.2

package/.github/workflows/publish.yml

@@ -8,6 +8,10 @@ on:
 env:
   SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
 
+permissions:
+  id-token: write  # Required for OIDC
+  contents: read
+
 jobs:
   publish:
     runs-on: ubuntu-latest
@@ -26,8 +30,6 @@ jobs:
 
       - name: Publish to npm 🚀
         run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Deploy notification
         if: always()

package/.oxfmtrc.jsonc

@@ -0,0 +1,7 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "arrowParens": "always",
+  "printWidth": 180,
+  "semi": true,
+  "singleQuote": true,
+}

package/CHANGELOG.md

@@ -2,33 +2,47 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [0.3.16](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.15...v0.3.16) (2025-09-05)
+### [1.0.2](https://github.com/lenneTech/nuxt-base-starter/compare/v1.0.1...v1.0.2) (2026-01-12)
 
 
 ### Bug Fixes
 
-* Update environment variable for bug feature toggle ([d875b3e](https://github.com/lenneTech/nuxt-base-starter/commit/d875b3eb586368499b9e628cdabd2f971e7cce7f))
+* add repository field in package.json ([1f43eae](https://github.com/lenneTech/nuxt-base-starter/commit/1f43eae4445b2f8a54cf4442c79be1bd55cf711c))
 
-### [0.3.15](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.14...v0.3.15) (2025-09-05)
+### [1.0.1](https://github.com/lenneTech/nuxt-base-starter/compare/v1.0.0...v1.0.1) (2026-01-12)
+
+## [1.0.0](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.17...v1.0.0) (2026-01-12)
+
+
+### Bug Fixes
+
+* **DEV-609:** removed duplicate public folder inside app ([#10](https://github.com/lenneTech/nuxt-base-starter/issues/10)) ([25fe0fe](https://github.com/lenneTech/nuxt-base-starter/commit/25fe0fe3c53bc3400373d9c3f0a4b6705952171b))
+
+### [0.3.17](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.16...v0.3.17) (2025-10-17)
 
+### [0.3.16](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.15...v0.3.16) (2025-09-05)
+
+### Bug Fixes
+
+- Update environment variable for bug feature toggle ([d875b3e](https://github.com/lenneTech/nuxt-base-starter/commit/d875b3eb586368499b9e628cdabd2f971e7cce7f))
+
+### [0.3.15](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.14...v0.3.15) (2025-09-05)
 
 ### Features
 
-* Add Linear API configuration and update dependencies ([291adfd](https://github.com/lenneTech/nuxt-base-starter/commit/291adfd8ee6e2c464c4b7c74e4c27531bda3892e))
+- Add Linear API configuration and update dependencies ([291adfd](https://github.com/lenneTech/nuxt-base-starter/commit/291adfd8ee6e2c464c4b7c74e4c27531bda3892e))
 
 ### [0.3.14](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.13...v0.3.14) (2025-08-01)
 
-
 ### Bug Fixes
 
-* **DEV-446:** Replace pnpm with npm for dependency installation and project commands ([8274c25](https://github.com/lenneTech/nuxt-base-starter/commit/8274c255384b841862d2d70a12c19ea30ecbb9d8))
+- **DEV-446:** Replace pnpm with npm for dependency installation and project commands ([8274c25](https://github.com/lenneTech/nuxt-base-starter/commit/8274c255384b841862d2d70a12c19ea30ecbb9d8))
 
 ### [0.3.13](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.12...v0.3.13) (2025-07-24)
 
-
 ### Bug Fixes
 
-* Update [@lenne](https://github.com/lenne).tech/nuxt-base dependency to latest version ([71dd666](https://github.com/lenneTech/nuxt-base-starter/commit/71dd6669fd9ec25671a102b4d2ad294ac88daa10))
+- Update [@lenne](https://github.com/lenne).tech/nuxt-base dependency to latest version ([71dd666](https://github.com/lenneTech/nuxt-base-starter/commit/71dd6669fd9ec25671a102b4d2ad294ac88daa10))
 
 ### [0.3.12](https://github.com/lenneTech/nuxt-base-starter/compare/v0.3.11...v0.3.12) (2025-07-24)
 

package/nuxt-base-template/.dockerignore

@@ -0,0 +1,44 @@
+# Dependencies
+node_modules
+.npm
+
+# Build output
+.nuxt
+.output
+dist
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# Logs
+*.log
+npm-debug.log*
+
+# Testing
+coverage
+test-results
+playwright-report
+
+# Environment
+.env.local
+.env.*.local
+
+# Git
+.git
+.gitignore
+
+# Docker
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# Documentation
+*.md
+!README.md
+
+# Misc
+.DS_Store
+*.tgz

package/nuxt-base-template/.env.example

@@ -9,4 +9,4 @@ GENERATE_TYPES=0
 
 LINEAR_API_KEY=
 LINEAR_TEAM_NAME=
-LINEAR_PROJECT_NAME=
+LINEAR_PROJECT_NAME=

package/nuxt-base-template/.nuxtrc

@@ -0,0 +1 @@
+setups.@nuxt/test-utils="3.23.0"

package/nuxt-base-template/.oxfmtrc.jsonc

@@ -0,0 +1,8 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "arrowParens": "always",
+  "printWidth": 180,
+  "semi": true,
+  "singleQuote": true,
+  "ignorePatterns": [".nuxt", ".output", "node_modules", "dist"],
+}

package/nuxt-base-template/Dockerfile.dev

@@ -0,0 +1,23 @@
+FROM node:22-alpine
+
+WORKDIR /app
+
+# Install dependencies for native modules
+RUN apk add --no-cache python3 make g++
+
+# Copy package files first for better caching
+COPY package*.json ./
+COPY .npmrc ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy entrypoint script
+COPY docker-entrypoint.sh /docker-entrypoint.sh
+RUN chmod +x /docker-entrypoint.sh
+
+# Expose port
+EXPOSE 3001
+
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0"]

package/nuxt-base-template/README.md

@@ -1,25 +1,33 @@
-# Nuxt 3 Minimal Starter
+# Nuxt Base Template
 
-Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
+A modern Nuxt 4 SSR starter template with TypeScript, Tailwind CSS v4, and NuxtUI.
+
+## Requirements
+
+- Node.js >= 22
+- npm >= 10
 
 ## Setup
 
-Make sure to install the dependencies:
+Install dependencies:
 
 ```bash
-# yarn
-yarn install
-
-# npm
 npm install
+# or
+npm run init
+```
+
+Copy environment variables:
 
-# pnpm
-pnpm install
+```bash
+cp .env.example .env
 ```
 
-## Development Server
+Configure your `.env` file with the required values (see Environment Variables section below).
 
-Start the development server on http://localhost:3000
+## Development
+
+Start the development server on http://localhost:3001
 
 ```bash
 npm run dev
@@ -33,10 +41,116 @@ Build the application for production:
 npm run build
 ```
 
-Locally preview production build:
+Preview production build locally:
 
 ```bash
 npm run preview
 ```
 
-Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
+Build for specific environments:
+
+```bash
+npm run build:develop    # Development environment
+npm run build:test       # Test environment
+npm run build:prod       # Production environment
+```
+
+## Code Quality
+
+Run linting and formatting checks before committing:
+
+```bash
+npm run check           # Run lint + format check
+npm run fix             # Auto-fix lint + format issues
+npm run lint            # ESLint only
+npm run format          # Prettier format only
+```
+
+## Testing
+
+Run E2E tests with Playwright:
+
+```bash
+npm run test
+```
+
+## API Integration
+
+Generate TypeScript types from OpenAPI schema:
+
+```bash
+npm run generate-types
+```
+
+## Tech Stack
+
+- **Framework:** Nuxt 4.1.3 (Vue 3 Composition API)
+- **Language:** TypeScript 5.9.3
+- **Styling:** Tailwind CSS 4.1.14
+- **UI Library:** NuxtUI 4.0.1
+- **State Management:** Pinia
+- **Testing:** Playwright
+- **API Client:** @hey-api/client-fetch
+- **Form Validation:** Valibot
+
+## Key Features
+
+- ✅ Full TypeScript support with strict typing
+- ✅ NuxtUI component library with semantic colors
+- ✅ Dark/light mode support
+- ✅ SEO optimization (sitemap, robots.txt, OG images)
+- ✅ Auto-generated API client from OpenAPI schema
+- ✅ E2E testing with Playwright
+- ✅ ESLint + Prettier configuration
+- ✅ Plausible Analytics integration
+- ✅ Image optimization with NuxtImage
+- ✅ Bug reporting to Linear (dev only)
+
+## Environment Variables
+
+Create a `.env` file with the following variables:
+
+```env
+SITE_URL=http://localhost:3001
+API_URL=http://localhost:3000
+APP_ENV=development
+NODE_ENV=development
+```
+
+Optional variables:
+
+```env
+WEB_PUSH_KEY=                # Web push notifications
+LINEAR_API_KEY=              # Bug reporting
+LINEAR_TEAM_NAME=            # Bug reporting
+LINEAR_PROJECT_NAME=         # Bug reporting
+API_SCHEMA=../api/schema.gql # API schema path
+STORAGE_PREFIX=base-dev      # Local storage prefix
+```
+
+## Project Structure
+
+```
+app/
+├── assets/          # Tailwind CSS configuration
+├── components/      # Vue components (auto-imported)
+├── composables/     # Composables (auto-imported)
+├── interfaces/      # TypeScript interfaces (auto-imported)
+├── layouts/         # Nuxt layouts
+├── pages/           # File-based routing
+└── app.config.ts    # NuxtUI configuration
+
+docs/                # Dev-only documentation layer
+tests/               # Playwright E2E tests
+```
+
+## Development Guidelines
+
+For detailed coding standards and architecture information, see [CLAUDE.md](./CLAUDE.md).
+
+## Documentation
+
+- [Nuxt Documentation](https://nuxt.com/docs)
+- [NuxtUI Documentation](https://ui.nuxt.com)
+- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
+- [Vue 3 Documentation](https://vuejs.org)

package/nuxt-base-template/app/app.config.ts

@@ -0,0 +1,67 @@
+export default defineAppConfig({
+  // ============================================================================
+  // Toast Notifications
+  // ============================================================================
+  toaster: {
+    duration: 5000,
+    expand: false,
+    position: 'bottom-right' as const,
+  },
+
+  // ============================================================================
+  // NuxtUI Configuration
+  // ============================================================================
+  ui: {
+    // Base component modifications
+    button: {
+      slots: {
+        base: 'cursor-pointer',
+      },
+    },
+    checkbox: {
+      slots: {
+        base: 'cursor-pointer',
+      },
+    },
+
+    // Semantic color palette (must match tailwind.css)
+    colors: {
+      error: 'error',
+      info: 'info',
+      neutral: 'neutral',
+      primary: 'primary',
+      secondary: 'secondary',
+      success: 'success',
+      warning: 'warning',
+    },
+
+    // Form field styling
+    formField: {
+      slots: {
+        description: 'text-sm text-neutral-400 dark:text-neutral-500',
+      },
+    },
+
+    // Dark/Light mode icons
+    icons: {
+      dark: 'i-lucide-moon',
+      light: 'i-lucide-sun-medium',
+    },
+
+    // Modal defaults
+    modal: {
+      slots: {
+        content: 'w-full max-w-2xl',
+        footer: 'flex justify-end gap-3 px-4 py-3',
+      },
+    },
+
+    // Toast notifications
+    toast: {
+      root: 'pointer-events-auto',
+      slots: {
+        close: 'text-neutral-900 dark:text-white',
+      },
+    },
+  },
+});

package/nuxt-base-template/app/app.vue

@@ -1,7 +1,15 @@
+<script setup lang="ts">
+// ============================================================================
+// Composables
+// ============================================================================
+const appConfig: ReturnType<typeof useAppConfig> = useAppConfig();
+</script>
+
 <template>
-  <div>
+  <UApp :toaster="appConfig.toaster">
+    <NuxtLoadingIndicator color="var(--ui-primary)" :height="2" />
     <NuxtLayout>
       <NuxtPage />
     </NuxtLayout>
-  </div>
+  </UApp>
 </template>

package/nuxt-base-template/app/assets/css/tailwind.css

@@ -1,98 +1,138 @@
 @import 'tailwindcss';
+@import '@nuxt/ui';
 
-@config "../../../tailwind.config.js";
-
-@plugin '@tailwindcss/typography';
-@plugin '@tailwindcss/forms';
+@plugin "@tailwindcss/typography";
 
 @custom-variant dark (&:is(.dark *));
+@custom-variant light (&:is(.light *));
 
-@theme {
-  --color-primary-50: #f3faf7;
-  --color-primary-100: #d6f1e7;
-  --color-primary-200: #ade2d0;
-  --color-primary-300: #7cccb3;
-  --color-primary-400: #57b39a;
-  --color-primary-500: #37957d;
-  --color-primary-600: #2a7765;
-  --color-primary-700: #256052;
-  --color-primary-800: #224d45;
-  --color-primary-900: #20413a;
-  --color-primary-950: #0d2621;
-  --color-primary: #57b39a;
-
-  --color-background: #ffffff;
-  --color-foreground: #000000;
-  --color-border: hsl(0 0% 0% / 0.5);
-  --color-hover: hsl(0 0% 100% / 0.2);
-  --color-active: hsl(0 0% 100% / 0.2);
-
+@theme static {
   --breakpoint-3xl: 2400px;
 
-  --button-radius: 24px;
-  --button-padding-y: 3px;
-  --button-padding-x: 16px;
-}
+  /* ============================================================================
+     NuxtUI Color Scales - Customize for your brand
+     Each semantic color requires a scale from 50 to 950
+     ========================================================================= */
 
-/*
-  The default border color has changed to `currentColor` in Tailwind CSS v4,
-  so we've added these compatibility styles to make sure everything still
-  looks the same as it did with Tailwind CSS v3.
-
-  If we ever want to remove these styles, we need to add an explicit border
-  color utility to any element that depends on these defaults.
-*/
-@layer base {
-  *,
-  ::after,
-  ::before,
-  ::backdrop,
-  ::file-selector-button {
-    border-color: var(--color-gray-200, currentColor);
-  }
-}
+  /* Primary Color - Green (NuxtUI Default) */
+  --ui-color-primary-50: #f0fdf4;
+  --ui-color-primary-100: #dcfce7;
+  --ui-color-primary-200: #bbf7d0;
+  --ui-color-primary-300: #86efac;
+  --ui-color-primary-400: #4ade80;
+  --ui-color-primary-500: #22c55e;
+  --ui-color-primary-600: #16a34a;
+  --ui-color-primary-700: #15803d;
+  --ui-color-primary-800: #166534;
+  --ui-color-primary-900: #14532d;
+  --ui-color-primary-950: #052e16;
+
+  /* Secondary Color - Indigo */
+  --ui-color-secondary-50: #eef2ff;
+  --ui-color-secondary-100: #e0e7ff;
+  --ui-color-secondary-200: #c7d2fe;
+  --ui-color-secondary-300: #a5b4fc;
+  --ui-color-secondary-400: #818cf8;
+  --ui-color-secondary-500: #6366f1;
+  --ui-color-secondary-600: #4f46e5;
+  --ui-color-secondary-700: #4338ca;
+  --ui-color-secondary-800: #3730a3;
+  --ui-color-secondary-900: #312e81;
+  --ui-color-secondary-950: #1e1b4b;
+
+  /* Success Color - Emerald */
+  --ui-color-success-50: #ecfdf5;
+  --ui-color-success-100: #d1fae5;
+  --ui-color-success-200: #a7f3d0;
+  --ui-color-success-300: #6ee7b7;
+  --ui-color-success-400: #34d399;
+  --ui-color-success-500: #10b981;
+  --ui-color-success-600: #059669;
+  --ui-color-success-700: #047857;
+  --ui-color-success-800: #065f46;
+  --ui-color-success-900: #064e3b;
+  --ui-color-success-950: #022c22;
+
+  /* Info Color - Blue */
+  --ui-color-info-50: #eff6ff;
+  --ui-color-info-100: #dbeafe;
+  --ui-color-info-200: #bfdbfe;
+  --ui-color-info-300: #93c5fd;
+  --ui-color-info-400: #60a5fa;
+  --ui-color-info-500: #3b82f6;
+  --ui-color-info-600: #2563eb;
+  --ui-color-info-700: #1d4ed8;
+  --ui-color-info-800: #1e40af;
+  --ui-color-info-900: #1e3a8a;
+  --ui-color-info-950: #172554;
+
+  /* Warning Color - Amber */
+  --ui-color-warning-50: #fffbeb;
+  --ui-color-warning-100: #fef3c7;
+  --ui-color-warning-200: #fde68a;
+  --ui-color-warning-300: #fcd34d;
+  --ui-color-warning-400: #fbbf24;
+  --ui-color-warning-500: #f59e0b;
+  --ui-color-warning-600: #d97706;
+  --ui-color-warning-700: #b45309;
+  --ui-color-warning-800: #92400e;
+  --ui-color-warning-900: #78350f;
+  --ui-color-warning-950: #451a03;
+
+  /* Error Color - Red */
+  --ui-color-error-50: #fef2f2;
+  --ui-color-error-100: #fee2e2;
+  --ui-color-error-200: #fecaca;
+  --ui-color-error-300: #fca5a5;
+  --ui-color-error-400: #f87171;
+  --ui-color-error-500: #ef4444;
+  --ui-color-error-600: #dc2626;
+  --ui-color-error-700: #b91c1c;
+  --ui-color-error-800: #991b1b;
+  --ui-color-error-900: #7f1d1d;
+  --ui-color-error-950: #450a0a;
+
+  /* Neutral Color - Slate */
+  --ui-color-neutral-50: #f8fafc;
+  --ui-color-neutral-100: #f1f5f9;
+  --ui-color-neutral-200: #e2e8f0;
+  --ui-color-neutral-300: #cbd5e1;
+  --ui-color-neutral-400: #94a3b8;
+  --ui-color-neutral-500: #64748b;
+  --ui-color-neutral-600: #475569;
+  --ui-color-neutral-700: #334155;
+  --ui-color-neutral-800: #1e293b;
+  --ui-color-neutral-900: #0f172a;
+  --ui-color-neutral-950: #020617;
+
+  /* ============================================================================
+     NuxtUI Semantic Shortcuts
+     ========================================================================= */
+
+  --ui-primary: var(--ui-color-primary-500);
+  --ui-secondary: var(--ui-color-secondary-500);
+  --ui-success: var(--ui-color-success-500);
+  --ui-info: var(--ui-color-info-500);
+  --ui-warning: var(--ui-color-warning-500);
+  --ui-error: var(--ui-color-error-500);
+
+  /* ============================================================================
+     NuxtUI Global Settings
+     ========================================================================= */
 
-@layer base {
-  body {
-    @apply transition-colors duration-300;
-  }
-  h1 {
-    @apply text-[32px] leading-[140%] lg:text-[66px] lg:leading-[140%] font-bold;
-  }
-  h2 {
-    @apply text-[28px] leading-[140%] lg:text-[51px] lg:leading-[140%] font-semibold;
-  }
-  h3 {
-    @apply text-[21px] leading-[140%] lg:text-[39px] lg:leading-[140%] font-bold;
-  }
-  h4 {
-    @apply text-[18px] leading-[140%] lg:text-[30px] lg:leading-[140%] font-bold;
-  }
-  h5 {
-    @apply text-[15px] leading-[140%] lg:text-[23px] lg:leading-[140%] font-bold;
-  }
-  h6 {
-    @apply text-[16px] leading-[140%] lg:text-[18px] lg:leading-[140%] font-bold;
-  }
-  p {
-    @apply text-[15px] leading-[140%] lg:text-[18px] lg:leading-[140%];
-  }
-  small {
-    @apply text-[14px] leading-[140%] lg:text-[16px] lg:leading-[140%];
-  }
-  a {
-    @apply text-[15px] leading-[140%] lg:text-[18px] lg:leading-[140%];
-  }
-  button {
-    @apply text-[15px] leading-[140%] lg:text-[18px] lg:leading-[140%];
-  }
+  --ui-radius: 0.5rem;
 }
 
-html,
-body {
-  height: 100%;
+.dark {
+  /* Adjust primary color for dark mode */
+  --ui-primary: var(--ui-color-primary-400);
+  --ui-secondary: var(--ui-color-secondary-400);
+  --ui-success: var(--ui-color-success-400);
+  --ui-info: var(--ui-color-info-400);
+  --ui-warning: var(--ui-color-warning-400);
+  --ui-error: var(--ui-color-error-400);
 }
 
-#__nuxt {
-  height: 100%;
+html {
+  @apply scroll-pt-24;
 }