solokit 0.1.1__py3-none-any.whl

solokit/templates/fullstack_nextjs/docker/docker-compose.prod.yml

@@ -0,0 +1,57 @@
+version: '3.8'
+
+services:
+  # PostgreSQL database for production
+  db:
+    image: postgres:16-alpine
+    container_name: fullstack-nextjs-db-prod
+    restart: always
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: ${POSTGRES_DB:-mydb}
+    ports:
+      - '5432:5432'
+    volumes:
+      - postgres_data_prod:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U postgres']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app_network
+
+  # Next.js application (production)
+  app:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+      target: runner
+    container_name: fullstack-nextjs-app-prod
+    restart: always
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      - NODE_ENV=production
+      - DATABASE_URL=postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB:-mydb}?schema=public
+      - SENTRY_DSN=${SENTRY_DSN}
+    ports:
+      - '3000:3000'
+    networks:
+      - app_network
+    healthcheck:
+      test: ['CMD', 'wget', '--spider', '-q', 'http://localhost:3000/api/health']
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+volumes:
+  postgres_data_prod:
+    driver: local
+
+networks:
+  app_network:
+    driver: bridge

solokit/templates/fullstack_nextjs/docker/docker-compose.yml

@@ -0,0 +1,47 @@
+version: '3.8'
+
+services:
+  # PostgreSQL database for development
+  db:
+    image: postgres:16-alpine
+    container_name: fullstack-nextjs-db
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: mydb
+    ports:
+      - '5432:5432'
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U postgres']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # Next.js application (development)
+  app:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+      target: builder
+    container_name: fullstack-nextjs-app
+    restart: unless-stopped
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      - NODE_ENV=development
+      - DATABASE_URL=postgresql://postgres:postgres@db:5432/mydb?schema=public
+    ports:
+      - '3000:3000'
+    volumes:
+      - ..:/app
+      - /app/node_modules
+      - /app/.next
+    command: npm run dev
+
+volumes:
+  postgres_data:
+    driver: local

solokit/templates/fullstack_nextjs/tier-1-essential/.eslintrc.json

@@ -0,0 +1,7 @@
+{
+  "extends": ["next/core-web-vitals", "next/typescript"],
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

solokit/templates/fullstack_nextjs/tier-1-essential/jest.config.ts

@@ -0,0 +1,17 @@
+import type { Config } from 'jest'
+import nextJest from 'next/jest.js'
+
+const createJestConfig = nextJest({
+  // Provide the path to your Next.js app to load next.config.js and .env files in your test environment
+  dir: './',
+})
+
+// Add any custom config to be passed to Jest
+const config: Config = {
+  coverageProvider: 'v8',
+  testEnvironment: 'jsdom',
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
+}
+
+// createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async
+export default createJestConfig(config)

solokit/templates/fullstack_nextjs/tier-1-essential/jest.setup.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom'

solokit/templates/fullstack_nextjs/tier-1-essential/package.json.tier1.template

@@ -0,0 +1,48 @@
+{
+  "name": "{project_name}",
+  "version": "0.1.0",
+  "description": "{project_description}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,md}\""
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "prisma": "6.19.0",
+    "@prisma/client": "6.19.0",
+    "zod": "4.1.12",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@types/node": "20.19.24",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "eslint": "9.39.1",
+    "eslint-config-next": "16.0.1",
+    "@typescript-eslint/parser": "8.46.3",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "prettier": "3.6.2",
+    "jest": "30.2.0",
+    "@types/jest": "30.0.0",
+    "ts-jest": "29.4.5",
+    "jest-environment-jsdom": "30.2.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/jest-dom": "6.9.1"
+  }
+}

solokit/templates/fullstack_nextjs/tier-1-essential/tests/api/example.test.ts

@@ -0,0 +1,88 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+import { NextRequest } from "next/server";
+import { GET, POST } from "@/app/api/example/route";
+
+// Mock Prisma client
+jest.mock("@/lib/prisma", () => ({
+  prisma: {
+    user: {
+      findMany: jest.fn(),
+      create: jest.fn(),
+    },
+  },
+}));
+
+// Import the mocked prisma after mocking
+import { prisma } from "@/lib/prisma";
+
+describe("API Route: /api/example", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe("GET", () => {
+    it("should return a greeting message and users", async () => {
+      const mockUsers = [
+        { id: 1, name: "John Doe", email: "john@example.com", createdAt: new Date(), updatedAt: new Date() },
+      ];
+
+      (prisma.user.findMany as jest.Mock).mockResolvedValue(mockUsers);
+
+      const response = await GET();
+      const data = await response.json();
+
+      expect(response.status).toBe(200);
+      expect(data).toHaveProperty("message");
+      expect(data).toHaveProperty("users");
+      expect(data.users).toEqual(mockUsers);
+    });
+
+    it("should handle database errors", async () => {
+      (prisma.user.findMany as jest.Mock).mockRejectedValue(new Error("Database error"));
+
+      const response = await GET();
+      const data = await response.json();
+
+      expect(response.status).toBe(500);
+      expect(data).toHaveProperty("error");
+    });
+  });
+
+  describe("POST", () => {
+    it("should create a new user with valid data", async () => {
+      const mockUser = {
+        id: 1,
+        name: "Jane Doe",
+        email: "jane@example.com",
+        createdAt: new Date(),
+        updatedAt: new Date(),
+      };
+
+      (prisma.user.create as jest.Mock).mockResolvedValue(mockUser);
+
+      const request = new NextRequest("http://localhost:3000/api/example", {
+        method: "POST",
+        body: JSON.stringify({ name: "Jane Doe", email: "jane@example.com" }),
+      });
+
+      const response = await POST(request);
+      const data = await response.json();
+
+      expect(response.status).toBe(201);
+      expect(data).toEqual(mockUser);
+    });
+
+    it("should return validation error for invalid data", async () => {
+      const request = new NextRequest("http://localhost:3000/api/example", {
+        method: "POST",
+        body: JSON.stringify({ name: "", email: "invalid-email" }),
+      });
+
+      const response = await POST(request);
+      const data = await response.json();
+
+      expect(response.status).toBe(400);
+      expect(data).toHaveProperty("error", "Validation failed");
+    });
+  });
+});

solokit/templates/fullstack_nextjs/tier-1-essential/tests/setup.ts

@@ -0,0 +1,22 @@
+// Add custom jest matchers from jest-dom
+import "@testing-library/jest-dom";
+
+// Mock Next.js router
+jest.mock("next/navigation", () => ({
+  useRouter() {
+    return {
+      push: jest.fn(),
+      replace: jest.fn(),
+      prefetch: jest.fn(),
+    };
+  },
+  useSearchParams() {
+    return new URLSearchParams();
+  },
+  usePathname() {
+    return "";
+  },
+}));
+
+// Mock environment variables
+process.env.NEXT_PUBLIC_APP_URL = "http://localhost:3000";

solokit/templates/fullstack_nextjs/tier-1-essential/tests/unit/example.test.tsx

@@ -0,0 +1,22 @@
+import { render, screen } from "@testing-library/react";
+import { describe, it, expect } from "@jest/globals";
+import ExampleComponent from "@/components/example-component";
+
+describe("ExampleComponent", () => {
+  it("should render the component with initial count", () => {
+    render(<ExampleComponent />);
+    expect(screen.getByText(/Count:/i)).toBeInTheDocument();
+    expect(screen.getByText(/0/)).toBeInTheDocument();
+  });
+
+  it("should have an increment button", () => {
+    render(<ExampleComponent />);
+    const button = screen.getByRole("button", { name: /increment/i });
+    expect(button).toBeInTheDocument();
+  });
+
+  it("should render the title", () => {
+    render(<ExampleComponent />);
+    expect(screen.getByText(/Client Component Example/i)).toBeInTheDocument();
+  });
+});

solokit/templates/fullstack_nextjs/tier-2-standard/package.json.tier2.template

@@ -0,0 +1,52 @@
+{
+  "name": "{project_name}",
+  "version": "0.1.0",
+  "description": "{project_description}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "prepare": "husky install",
+    "audit": "npm audit --audit-level=moderate"
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "prisma": "6.19.0",
+    "@prisma/client": "6.19.0",
+    "zod": "4.1.12",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@types/node": "20.19.24",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "eslint": "9.39.1",
+    "eslint-config-next": "16.0.1",
+    "@typescript-eslint/parser": "8.46.3",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "prettier": "3.6.2",
+    "jest": "30.2.0",
+    "@types/jest": "30.0.0",
+    "ts-jest": "29.4.5",
+    "jest-environment-jsdom": "30.2.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "husky": "9.1.7",
+    "lint-staged": "16.2.6"
+  }
+}

solokit/templates/fullstack_nextjs/tier-3-comprehensive/eslint.config.mjs

@@ -0,0 +1,39 @@
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends("next/core-web-vitals", "next/typescript"),
+  {
+    plugins: {
+      "jest-dom": (await import("eslint-plugin-jest-dom")).default,
+      "testing-library": (await import("eslint-plugin-testing-library")).default,
+    },
+    rules: {
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/no-explicit-any": "warn",
+      // jest-dom rules
+      "jest-dom/prefer-checked": "error",
+      "jest-dom/prefer-enabled-disabled": "error",
+      "jest-dom/prefer-required": "error",
+      "jest-dom/prefer-to-have-attribute": "error",
+      // testing-library rules
+      "testing-library/await-async-queries": "error",
+      "testing-library/no-await-sync-queries": "error",
+      "testing-library/no-debugging-utils": "warn",
+      "testing-library/prefer-screen-queries": "error",
+    },
+  },
+];
+
+export default eslintConfig;

solokit/templates/fullstack_nextjs/tier-3-comprehensive/package.json.tier3.template

@@ -0,0 +1,68 @@
+{
+  "name": "{project_name}",
+  "version": "0.1.0",
+  "description": "{project_description}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:integration": "jest --testPathPattern=integration",
+    "test:mutation": "stryker run",
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "prepare": "husky install",
+    "audit": "npm audit --audit-level=moderate",
+    "check:duplication": "jscpd .",
+    "check:types": "type-coverage"
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "prisma": "6.19.0",
+    "@prisma/client": "6.19.0",
+    "zod": "4.1.12",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@types/node": "20.19.24",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "eslint": "9.39.1",
+    "eslint-config-next": "16.0.1",
+    "@typescript-eslint/parser": "8.46.3",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "prettier": "3.6.2",
+    "jest": "30.2.0",
+    "@types/jest": "30.0.0",
+    "ts-jest": "29.4.5",
+    "jest-environment-jsdom": "30.2.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "husky": "9.1.7",
+    "lint-staged": "16.2.6",
+    "jscpd": "4.0.5",
+    "ts-prune": "0.10.3",
+    "type-coverage": "2.29.7",
+    "@stryker-mutator/core": "9.3.0",
+    "@stryker-mutator/jest-runner": "9.3.0",
+    "@playwright/test": "1.56.1",
+    "playwright": "1.56.1",
+    "@axe-core/playwright": "4.11.0",
+    "eslint-plugin-jest-dom": "5.5.0",
+    "eslint-plugin-testing-library": "7.13.3"
+  }
+}

solokit/templates/fullstack_nextjs/tier-3-comprehensive/playwright.config.ts

@@ -0,0 +1,66 @@
+import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// require('dotenv').config();
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export default defineConfig({
+  testDir: './tests/e2e',
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  forbidOnly: !!process.env.CI,
+  /* Retry on CI only */
+  retries: process.env.CI ? 2 : 0,
+  /* Opt out of parallel tests on CI. */
+  workers: process.env.CI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: 'html',
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Base URL to use in actions like `await page.goto('/')`. */
+    baseURL: 'http://localhost:3000',
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+
+    /* Test against mobile viewports. */
+    {
+      name: 'Mobile Chrome',
+      use: { ...devices['Pixel 5'] },
+    },
+    {
+      name: 'Mobile Safari',
+      use: { ...devices['iPhone 12'] },
+    },
+  ],
+
+  /* Run your local dev server before starting the tests */
+  webServer: {
+    command: 'npm run dev',
+    url: 'http://localhost:3000',
+    reuseExistingServer: !process.env.CI,
+  },
+});

solokit/templates/fullstack_nextjs/tier-3-comprehensive/stryker.conf.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "./node_modules/@stryker-mutator/core/schema/stryker-schema.json",
+  "packageManager": "npm",
+  "reporters": ["html", "clear-text", "progress"],
+  "testRunner": "jest",
+  "jest": {
+    "projectType": "custom",
+    "configFile": "jest.config.ts",
+    "enableFindRelatedTests": true
+  },
+  "coverageAnalysis": "perTest",
+  "mutate": [
+    "app/**/*.ts",
+    "app/**/*.tsx",
+    "lib/**/*.ts",
+    "!**/*.test.ts",
+    "!**/*.test.tsx",
+    "!**/*.spec.ts",
+    "!**/*.spec.tsx"
+  ],
+  "thresholds": {
+    "high": 80,
+    "low": 60,
+    "break": 50
+  },
+  "ignorePatterns": [
+    "node_modules",
+    ".next",
+    "coverage",
+    "dist",
+    "build"
+  ]
+}

solokit/templates/fullstack_nextjs/tier-3-comprehensive/tests/e2e/flow.spec.ts

@@ -0,0 +1,59 @@
+import { test, expect } from '@playwright/test';
+import { injectAxe, checkA11y } from 'axe-playwright';
+
+test.describe('Home Page', () => {
+  test('should load the home page', async ({ page }) => {
+    await page.goto('/');
+
+    // Check for the main heading
+    await expect(page.getByRole('heading', { name: /full-stack.*next\.js/i })).toBeVisible();
+  });
+
+  test('should display example component', async ({ page }) => {
+    await page.goto('/');
+
+    // Wait for the example component to load
+    await expect(page.getByText(/client component example/i)).toBeVisible();
+    await expect(page.getByText(/count:/i)).toBeVisible();
+  });
+
+  test('should have no accessibility violations', async ({ page }) => {
+    await page.goto('/');
+
+    // Inject axe-core
+    await injectAxe(page);
+
+    // Check for accessibility violations
+    await checkA11y(page, undefined, {
+      detailedReport: true,
+      detailedReportOptions: {
+        html: true,
+      },
+    });
+  });
+
+  test('should navigate and display cards', async ({ page }) => {
+    await page.goto('/');
+
+    // Check that both cards are visible
+    await expect(page.getByText(/api routes/i)).toBeVisible();
+    await expect(page.getByText(/database/i)).toBeVisible();
+  });
+
+  test('should have working increment button', async ({ page }) => {
+    await page.goto('/');
+
+    // Find and click the increment button
+    const button = page.getByRole('button', { name: /increment/i });
+    await expect(button).toBeVisible();
+
+    // Initial count should be 0
+    await expect(page.getByText(/count: 0/i)).toBeVisible();
+
+    // Click the button
+    await button.click();
+
+    // Count should now be 1
+    await expect(page.getByText(/count: 1/i)).toBeVisible();
+  });
+});