solokit 0.1.1__py3-none-any.whl

solokit/templates/dashboard_refine/base/components.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "app/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils"
+  }
+}

solokit/templates/dashboard_refine/base/lib/refine.tsx

@@ -0,0 +1,65 @@
+import routerProvider from "@refinedev/nextjs-router";
+
+/**
+ * Refine configuration
+ * This file centralizes all Refine-related configuration
+ */
+
+/**
+ * Data provider configuration
+ * TODO: Add a data provider when you have a backend API
+ * Example: import dataProvider from "@refinedev/simple-rest";
+ * Then: export const refineDataProvider = dataProvider(API_URL);
+ */
+export const refineDataProvider = undefined;
+
+/**
+ * Router provider configuration
+ * Integrates Refine with Next.js App Router
+ */
+export const refineRouterProvider = routerProvider;
+
+/**
+ * Resource definitions
+ * Define all resources that will be managed in the dashboard
+ */
+export const refineResources = [
+  {
+    name: "users",
+    list: "/dashboard/users",
+    create: "/dashboard/users/create",
+    edit: "/dashboard/users/edit/:id",
+    show: "/dashboard/users/show/:id",
+    meta: {
+      canDelete: true,
+    },
+  },
+  {
+    name: "orders",
+    list: "/dashboard/orders",
+    create: "/dashboard/orders/create",
+    edit: "/dashboard/orders/edit/:id",
+    show: "/dashboard/orders/show/:id",
+  },
+  {
+    name: "products",
+    list: "/dashboard/products",
+    create: "/dashboard/products/create",
+    edit: "/dashboard/products/edit/:id",
+    show: "/dashboard/products/show/:id",
+    meta: {
+      canDelete: true,
+    },
+  },
+];
+
+/**
+ * Refine options
+ * Global configuration for Refine behavior
+ */
+export const refineOptions = {
+  syncWithLocation: true,
+  warnWhenUnsavedChanges: true,
+  useNewQueryKeys: true,
+  projectId: "refine-dashboard",
+};

solokit/templates/dashboard_refine/base/lib/utils.ts

@@ -0,0 +1,13 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * Utility function to merge Tailwind CSS classes
+ *
+ * @example
+ * cn("px-2 py-1", "bg-blue-500") // "px-2 py-1 bg-blue-500"
+ * cn("px-2", condition && "py-1") // "px-2 py-1" or "px-2"
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

solokit/templates/dashboard_refine/base/next.config.ts

@@ -0,0 +1,10 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+
+  // Enable experimental features if needed
+    // Add experimental features here
+};
+
+export default nextConfig;

solokit/templates/dashboard_refine/base/package.json.template

@@ -0,0 +1,40 @@
+{
+  "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"
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "@refinedev/cli": "latest",
+    "@refinedev/core": "latest",
+    "@refinedev/nextjs-router": "latest",
+    "@refinedev/react-table": "latest",
+    "@refinedev/react-hook-form": "latest",
+    "recharts": "latest",
+    "react-hook-form": "7.66.0",
+    "zod": "4.1.12",
+    "@hookform/resolvers": "latest",
+    "lucide-react": "latest",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@types/node": "20.19.24",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2"
+  }
+}

solokit/templates/dashboard_refine/base/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

solokit/templates/dashboard_refine/base/providers/refine-provider.tsx

@@ -0,0 +1,26 @@
+"use client";
+
+import { Refine } from "@refinedev/core";
+import {
+  refineDataProvider,
+  refineRouterProvider,
+  refineResources,
+  refineOptions,
+} from "@/lib/refine";
+
+/**
+ * Refine Provider Component
+ * Wraps the application with Refine context and configuration
+ */
+export function RefineProvider({ children }: { children: React.ReactNode }) {
+  return (
+    <Refine
+      dataProvider={refineDataProvider}
+      routerProvider={refineRouterProvider}
+      resources={refineResources}
+      options={refineOptions}
+    >
+      {children}
+    </Refine>
+  );
+}

solokit/templates/dashboard_refine/base/tailwind.config.ts

@@ -0,0 +1,57 @@
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+  darkMode: "class",
+  content: [
+    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./app/**/*.{js,ts,jsx,tsx,mdx}",
+  ],
+  theme: {
+    extend: {
+      colors: {
+        border: "hsl(var(--border))",
+        input: "hsl(var(--input))",
+        ring: "hsl(var(--ring))",
+        background: "hsl(var(--background))",
+        foreground: "hsl(var(--foreground))",
+        primary: {
+          DEFAULT: "hsl(var(--primary))",
+          foreground: "hsl(var(--primary-foreground))",
+        },
+        secondary: {
+          DEFAULT: "hsl(var(--secondary))",
+          foreground: "hsl(var(--secondary-foreground))",
+        },
+        destructive: {
+          DEFAULT: "hsl(var(--destructive))",
+          foreground: "hsl(var(--destructive-foreground))",
+        },
+        muted: {
+          DEFAULT: "hsl(var(--muted))",
+          foreground: "hsl(var(--muted-foreground))",
+        },
+        accent: {
+          DEFAULT: "hsl(var(--accent))",
+          foreground: "hsl(var(--accent-foreground))",
+        },
+        popover: {
+          DEFAULT: "hsl(var(--popover))",
+          foreground: "hsl(var(--popover-foreground))",
+        },
+        card: {
+          DEFAULT: "hsl(var(--card))",
+          foreground: "hsl(var(--card-foreground))",
+        },
+      },
+      borderRadius: {
+        lg: "var(--radius)",
+        md: "calc(var(--radius) - 2px)",
+        sm: "calc(var(--radius) - 4px)",
+      },
+    },
+  },
+  plugins: [],
+};
+
+export default config;

solokit/templates/dashboard_refine/base/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

solokit/templates/dashboard_refine/docker/Dockerfile

@@ -0,0 +1,57 @@
+# syntax=docker/dockerfile:1
+
+# Base image
+FROM node:20-alpine AS base
+
+# Install dependencies only when needed
+FROM base AS deps
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Install dependencies based on the preferred package manager
+COPY package.json package-lock.json* ./
+RUN npm ci
+
+# Rebuild the source code only when needed
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+# Next.js collects completely anonymous telemetry data about general usage.
+# Learn more here: https://nextjs.org/telemetry
+# Uncomment the following line in case you want to disable telemetry during the build.
+# ENV NEXT_TELEMETRY_DISABLED 1
+
+RUN npm run build
+
+# Production image, copy all the files and run next
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV production
+# Uncomment the following line in case you want to disable telemetry during runtime.
+# ENV NEXT_TELEMETRY_DISABLED 1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+# Copy necessary files
+COPY --from=builder /app/public ./public
+COPY --from=builder /app/package.json ./package.json
+
+# Automatically leverage output traces to reduce image size
+# https://nextjs.org/docs/advanced-features/output-file-tracing
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT 3000
+ENV HOSTNAME "0.0.0.0"
+
+# server.js is created by next build from the standalone output
+# https://nextjs.org/docs/pages/api-reference/next-config-js/output
+CMD ["node", "server.js"]

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

@@ -0,0 +1,31 @@
+version: '3.8'
+
+services:
+  # Next.js application (production)
+  app:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+      target: runner
+    container_name: dashboard-refine-app-prod
+    restart: always
+    environment:
+      - NODE_ENV=production
+      - NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}
+      - SENTRY_DSN=${SENTRY_DSN}
+      - SENTRY_ORG=${SENTRY_ORG}
+      - SENTRY_PROJECT=${SENTRY_PROJECT}
+    ports:
+      - '3000:3000'
+    networks:
+      - app_network
+    healthcheck:
+      test: ['CMD', 'wget', '--spider', '-q', 'http://localhost:3000']
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+networks:
+  app_network:
+    driver: bridge

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

@@ -0,0 +1,21 @@
+version: '3.8'
+
+services:
+  # Next.js application (development)
+  app:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+      target: builder
+    container_name: dashboard-refine-app
+    restart: unless-stopped
+    environment:
+      - NODE_ENV=development
+      - NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL:-https://api.fake-rest.refine.dev}
+    ports:
+      - '3000:3000'
+    volumes:
+      - ..:/app
+      - /app/node_modules
+      - /app/.next
+    command: npm run dev

solokit/templates/dashboard_refine/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/dashboard_refine/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/dashboard_refine/tier-1-essential/jest.setup.ts

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

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

@@ -0,0 +1,57 @@
+{
+  "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",
+    "lint:fix": "next lint --fix",
+    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "@refinedev/cli": "2.16.50",
+    "@refinedev/core": "5.0.5",
+    "@refinedev/nextjs-router": "7.0.4",
+    "@refinedev/react-table": "6.0.1",
+    "@refinedev/react-hook-form": "5.0.2",
+    "recharts": "3.3.0",
+    "react-hook-form": "7.66.0",
+    "zod": "4.1.12",
+    "@hookform/resolvers": "5.2.2",
+    "lucide-react": "0.553.0",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17"
+  },
+  "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/dashboard_refine/tier-1-essential/tests/setup.ts

@@ -0,0 +1,26 @@
+// 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(),
+      back: jest.fn(),
+      pathname: "/",
+      query: {},
+      asPath: "/",
+    };
+  },
+  usePathname() {
+    return "/";
+  },
+  useSearchParams() {
+    return new URLSearchParams();
+  },
+}));
+
+// Mock environment variables
+process.env.NEXT_PUBLIC_API_URL = "https://api.fake-rest.refine.dev";

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

@@ -0,0 +1,73 @@
+import { render, screen } from "@testing-library/react";
+import { Button } from "@/components/ui/button";
+import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card";
+
+/**
+ * Example Component Tests using Jest
+ * These tests demonstrate the testing setup and best practices
+ */
+
+describe("Button Component", () => {
+  it("renders children correctly", () => {
+    render(<Button>Click me</Button>);
+    expect(screen.getByText("Click me")).toBeInTheDocument();
+  });
+
+  it("applies variant classes", () => {
+    render(<Button variant="destructive">Delete</Button>);
+    const button = screen.getByText("Delete");
+    expect(button).toBeInTheDocument();
+  });
+
+  it("handles click events", () => {
+    let clicked = false;
+    render(<Button onClick={() => (clicked = true)}>Click</Button>);
+    const button = screen.getByText("Click");
+    button.click();
+    expect(clicked).toBe(true);
+  });
+
+  it("is accessible with proper aria attributes", () => {
+    render(<Button aria-label="Submit form">Submit</Button>);
+    expect(screen.getByLabelText("Submit form")).toBeInTheDocument();
+  });
+});
+
+describe("Card Component", () => {
+  it("renders with all parts", () => {
+    render(
+      <Card>
+        <CardHeader>
+          <CardTitle>Test Card</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <p>Card content</p>
+        </CardContent>
+      </Card>
+    );
+
+    expect(screen.getByText("Test Card")).toBeInTheDocument();
+    expect(screen.getByText("Card content")).toBeInTheDocument();
+  });
+
+  it("applies custom className", () => {
+    const { container } = render(
+      <Card className="custom-class">
+        <CardContent>Content</CardContent>
+      </Card>
+    );
+
+    const card = container.querySelector(".custom-class");
+    expect(card).toBeInTheDocument();
+  });
+});
+
+describe("Utility Functions", () => {
+  it("cn() merges classes correctly", () => {
+    const { cn } = require("@/lib/utils");
+
+    expect(cn("px-2 py-1", "bg-blue-500")).toBe("px-2 py-1 bg-blue-500");
+    expect(cn("px-2", false && "py-1")).toBe("px-2");
+    expect(cn("px-2", true && "py-1")).toBe("px-2 py-1");
+  });
+});

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

@@ -0,0 +1,62 @@
+{
+  "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",
+    "lint:fix": "next lint --fix",
+    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
+    "prepare": "husky install",
+    "audit": "npm audit --audit-level=moderate"
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "@refinedev/cli": "2.16.50",
+    "@refinedev/core": "5.0.5",
+    "@refinedev/nextjs-router": "7.0.4",
+    "@refinedev/react-table": "6.0.1",
+    "@refinedev/react-hook-form": "5.0.2",
+    "recharts": "3.3.0",
+    "react-hook-form": "7.66.0",
+    "zod": "4.1.12",
+    "@hookform/resolvers": "5.2.2",
+    "lucide-react": "0.553.0",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17"
+  },
+  "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/dashboard_refine/tier-3-comprehensive/eslint.config.mjs

@@ -0,0 +1,22 @@
+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"),
+  {
+    rules: {
+      "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+      "@typescript-eslint/no-explicit-any": "warn",
+    },
+  },
+];
+
+export default eslintConfig;