vibefast-cli 0.2.4 → 0.3.0

package/2/apps/web/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/2/apps/web/lib/convex-provider.tsx

@@ -0,0 +1,18 @@
+"use client"
+
+import { ConvexAuthProvider } from "@convex-dev/auth/react";
+import { ConvexReactClient } from "convex/react";
+import { ReactNode } from "react";
+
+const convex = new ConvexReactClient(
+  process.env.NEXT_PUBLIC_CONVEX_URL as string
+);
+
+interface ConvexProviderProps {
+  children: ReactNode;
+}
+
+export function ConvexProvider({ children }: ConvexProviderProps) {
+  return <ConvexAuthProvider client={convex}>{children}</ConvexAuthProvider>;
+}
+

package/2/apps/web/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/2/apps/web/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

package/2/apps/web/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "web",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "@convex-dev/auth": "^0.0.87",
+    "@vibefast/backend": "workspace:*",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-icons": "^1.3.0",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-toast": "^1.2.1",
+    "@radix-ui/react-toggle": "^1.1.10",
+    "@radix-ui/react-toggle-group": "^1.1.11",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "convex": "^1.27.0",
+    "input-otp": "^1.4.2",
+    "lucide-react": "^0.553.0",
+    "next": "16.0.1",
+    "next-themes": "^0.3.0",
+    "react": "19.2.0",
+    "react-colorful": "^5.6.1",
+    "react-dom": "19.2.0",
+    "tailwind-merge": "^3.3.1"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.0.1",
+    "tailwindcss": "^4",
+    "tailwindcss-animate": "^1.0.7",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5"
+  }
+}

package/2/apps/web/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/2/apps/web/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/2/apps/web/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/2/apps/web/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/2/apps/web/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/2/apps/web/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/2/apps/web/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "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": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/2/bts.jsonc

@@ -0,0 +1,21 @@
+// Better-T-Stack configuration file
+// safe to delete
+
+{
+	"$schema": "https://r2.better-t-stack.dev/schema.json",
+	"version": "2.40.2",
+	"createdAt": "2025-09-02T18:59:56.447Z",
+	"database": "none",
+	"orm": "none",
+	"backend": "convex",
+	"runtime": "none",
+	"frontend": ["native-nativewind"],
+	"addons": ["turborepo"],
+	"examples": ["todo"],
+	"auth": "none",
+	"packageManager": "pnpm",
+	"dbSetup": "none",
+	"api": "none",
+	"webDeploy": "none",
+	"serverDeploy": "none"
+}

package/2/commitlint.config.js

@@ -0,0 +1 @@
+module.exports = { extends: ['@commitlint/config-conventional'] };

package/2/eslint.config.mjs

@@ -0,0 +1,182 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsParser from '@typescript-eslint/parser';
+import { defineConfig, globalIgnores } from 'eslint/config';
+import expoConfig from 'eslint-config-expo/flat.js';
+import i18nJsonPlugin from 'eslint-plugin-i18n-json';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import reactCompiler from 'eslint-plugin-react-compiler';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import tailwind from 'eslint-plugin-tailwindcss';
+import testingLibrary from 'eslint-plugin-testing-library';
+// eslint-disable-next-line import/namespace
+import eslintPluginUnicorn from 'eslint-plugin-unicorn';
+import unusedImports from 'eslint-plugin-unused-imports';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig([
+  globalIgnores([
+    'dist/*',
+    '.cursor',
+    '.claude',
+    'vf-agent/*',
+    'CLAUDE.md',
+    'node_modules',
+    '__tests__/',
+    'coverage',
+    '.expo',
+    '.expo-shared',
+    'pnpm-lock.yaml',
+    'android',
+    'ios',
+    '.vscode',
+    'docs/',
+    'cli/',
+    'expo-env.d.ts',
+  ]),
+  expoConfig,
+  eslintPluginPrettierRecommended,
+  ...tailwind.configs['flat/recommended'],
+  reactCompiler.configs.recommended,
+  {
+    plugins: {
+      'simple-import-sort': simpleImportSort,
+      unicorn: eslintPluginUnicorn,
+      'unused-imports': unusedImports,
+    },
+    rules: {
+      'tailwindcss/classnames-order': [
+        'warn',
+        {
+          officialSorting: true,
+        },
+      ],
+      'tailwindcss/no-custom-classname': 'off',
+      'react/display-name': 'off',
+      'react/no-inline-styles': 'off',
+      'react/destructuring-assignment': 'off',
+      'react/require-default-props': 'off',
+      'unicorn/filename-case': [
+        'error',
+        {
+          case: 'kebabCase',
+          ignore: ['/android', '/ios'],
+        },
+      ],
+      'simple-import-sort/imports': 'error',
+      'simple-import-sort/exports': 'error',
+      'unused-imports/no-unused-imports': 'warn',
+      'unused-imports/no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      'import/prefer-default-export': 'off',
+      'import/no-cycle': ['error', { maxDepth: '∞' }],
+      'import/no-named-as-default': 'off', // Allow using default imports for named exports
+      'import/no-named-as-default-member': 'off', // Allow accessing named exports from default import
+      'react-hooks/exhaustive-deps': 'warn', // Downgrade to warning instead of error
+      'react-compiler/react-compiler': 'warn', // Downgrade React Compiler warnings
+      'prettier/prettier': ['error', { ignores: ['expo-env.d.ts'] }],
+      // Global defaults; specific overrides apply per folder
+    },
+  },
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        project: './tsconfig.json',
+        sourceType: 'module',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      '@typescript-eslint/comma-dangle': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-expressions': 'off', // Allow patterns like: condition && doSomething()
+      '@typescript-eslint/consistent-type-imports': [
+        'warn',
+        {
+          prefer: 'type-imports',
+          fixStyle: 'inline-type-imports',
+          disallowTypeAnnotations: true,
+        },
+      ],
+    },
+  },
+  {
+    files: ['apps/native/src/translations/*.json'],
+    plugins: { 'i18n-json': i18nJsonPlugin },
+    processor: {
+      meta: { name: '.json' },
+      ...i18nJsonPlugin.processors['.json'],
+    },
+    rules: {
+      ...i18nJsonPlugin.configs.recommended.rules,
+      'i18n-json/valid-message-syntax': [
+        2,
+        {
+          syntax: path.resolve(
+            __dirname,
+            './scripts/i18next-syntax-validation.js',
+          ),
+        },
+      ],
+      'i18n-json/valid-json': 2,
+      'i18n-json/sorted-keys': [
+        2,
+        {
+          order: 'asc',
+          indentSpaces: 2,
+        },
+      ],
+      'i18n-json/identical-keys': [
+        2,
+        {
+          filePath: path.resolve(
+            __dirname,
+            './apps/native/src/translations/en.json',
+          ),
+        },
+      ],
+      'prettier/prettier': [
+        0,
+        {
+          singleQuote: true,
+          endOfLine: 'auto',
+        },
+      ],
+    },
+  },
+  {
+    files: ['**/__tests__/**/*.[jt]s?(x)', '**/?(*.)+(spec|test).[jt]s?(x)'],
+    plugins: { 'testing-library': testingLibrary },
+    rules: {
+      ...testingLibrary.configs.react.rules,
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-require-imports': 'off',
+      '@typescript-eslint/ban-ts-comment': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      'unused-imports/no-unused-vars': 'off',
+      'unused-imports/no-unused-imports': 'off',
+      'testing-library/no-unnecessary-act': 'off',
+      'testing-library/no-wait-for-multiple-assertions': 'off',
+    },
+  },
+  {
+    files: ['convex/**/*.ts'],
+    rules: {
+      'unicorn/filename-case': [
+        'error',
+        {
+          case: 'camelCase',
+        },
+      ],
+      'max-lines-per-function': 'off',
+    },
+  },
+]);

package/2/lint-staged.config.js

@@ -0,0 +1,16 @@
+module.exports = {
+  '**/*.{js,jsx,ts,tsx}': (filenames) => [
+    `npx eslint --fix ${filenames
+      .map((filename) => `"${filename}"`)
+      .join(' ')}`,
+  ],
+  '**/*.(md|json)': (filenames) =>
+    `npx prettier --write ${filenames
+      .map((filename) => `"${filename}"`)
+      .join(' ')}`,
+  'src/translations/*.(json)': (filenames) => [
+    `npx eslint --fix ${filenames
+      .map((filename) => `"${filename}"`)
+      .join(' ')}`,
+  ],
+};

package/2/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "vibefast",
+  "private": true,
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "scripts": {
+    "dev": "turbo dev",
+    "build": "turbo build",
+    "build:web": "turbo -F web build",
+    "build:backend": "turbo -F @vibefast/backend build",
+    "check-types": "turbo check-types",
+    "test": "turbo test",
+    "test:ci": "turbo test:ci",
+    "prebuild": "pnpm run native:prebuild",
+    "dev:native": "turbo -F native dev",
+    "dev:native:clear": "turbo -F native dev:clear",
+    "dev:web": "turbo -F web dev",
+    "dev:server": "turbo -F @vibefast/backend dev",
+    "dev:setup": "turbo -F @vibefast/backend dev:setup",
+    "lint": "turbo lint",
+    "lint:native": "pnpm --filter native lint",
+    "web-build": "cd apps/web && pnpm build",
+    "native:start": "pnpm --filter native run start",
+    "native:ios": "pnpm --filter native run ios",
+    "native:android": "pnpm --filter native run android",
+    "native:prebuild": "pnpm --filter native run prebuild",
+    "native:test": "pnpm --filter native run test",
+    "native:test:frontend": "pnpm --filter native run test:frontend",
+    "native:test:backend": "pnpm --filter native run test:backend",
+    "native:test:watch": "pnpm --filter native run test:watch",
+    "native:test:ci": "pnpm --filter native run test:ci",
+    "native:check-types": "pnpm --filter native run check-types",
+    "native:lint": "pnpm --filter native run lint",
+    "native:lint:translations": "pnpm --filter native run lint:translations",
+    "native:check-all": "pnpm --filter native run check-all",
+    "native:doctor": "pnpm --filter native run doctor",
+    "native:install-check": "pnpm --filter native exec pnpx expo install --check",
+    "native:expo:install": "pnpm --filter native exec pnpx expo install",
+    "native:expo:config": "pnpm --filter native exec pnpx expo config",
+    "native:expo:customize": "pnpm --filter native exec pnpx expo customize",
+    "native:xcode": "pnpm --filter native run xcode",
+    "native:e2e-test": "pnpm --filter native run e2e-test",
+    "native:setup:vosk": "pnpm --filter native run setup:vosk",
+    "native:setup:starter": "pnpm --filter native run setup:starter",
+    "native:setup:convex": "pnpm --filter native run setup:convex",
+    "native:build:apk": "pnpm --filter native run build:apk",
+    "native:start:staging": "pnpm --filter native run start:staging",
+    "native:start:production": "pnpm --filter native run start:production",
+    "native:prebuild:staging": "pnpm --filter native run prebuild:staging",
+    "native:prebuild:local": "pnpm --filter native run prebuild:local",
+    "native:prebuild:production": "pnpm --filter native run prebuild:production",
+    "native:ios:staging": "pnpm --filter native run ios:staging",
+    "native:android:staging": "pnpm --filter native run android:staging",
+    "native:ios:production": "pnpm --filter native run ios:production",
+    "native:android:production": "pnpm --filter native run android:production"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "turbo": "^2.5.4"
+  },
+  "packageManager": "pnpm@10.12.3"
+}

package/2/packages/backend/.env.example

@@ -0,0 +1,20 @@
+# Deployment used by `npx convex dev`
+# These are auto-generated when you run: npx convex dev
+CONVEX_DEPLOYMENT=dev:your-deployment-name
+CONVEX_URL=https://your-deployment.convex.cloud # Convex backend endpoint for API/agent requests
+CONVEX_SITE_URL=https://your-deployment.convex.cloud # Domain referenced in Convex auth/provider configuration
+
+# Convex feature flags and secrets (set in apps/native/.env.local before `pnpm native:setup:convex`)
+AUTH_RESEND_KEY= # Resend API key powering OTP and password-reset email delivery
+AUTH_EMAIL= # Sender address for verification/reset emails sent via Resend
+SEND_OTP_ON_SIGNUP=false # When true, force OTP verification for new email/password sign-ups
+OPENAI_API_KEY= # Required for OpenAI chat streaming, image generation, and image analysis
+GEMINI_API_KEY= # Required for Gemini chat/image generation/image analysis paths
+AI_PROVIDER=openai # Default AI provider used by Convex image analysis and assistants
+AI_MODEL=gpt-4o # Optional override for the model used by AI/chat/image workflows
+TAVILY_API_KEY= # Tavily search tool uses this to deliver up-to-date web lookups
+ELEVENLABS_API_KEY= # ElevenLabs voice token endpoint for voice conversation features
+CHAT_LATENCY_TELEMETRY_MODE=off # Controls chat latency telemetry sampling (off|sample|debug)
+
+# Reminder: Push the secrets above to Convex using `pnpm native:setup:convex` and access
+# them via `process.env` inside the backend (Convex injects them).

package/2/packages/backend/convex/README.md

@@ -0,0 +1,90 @@
+# Welcome to your Convex functions directory!
+
+Write your Convex functions here.
+See https://docs.convex.dev/functions for more.
+
+A query function that takes two arguments looks like:
+
+```ts
+// functions.js
+import { query } from './_generated/server';
+import { v } from 'convex/values';
+
+export const myQueryFunction = query({
+  // Validators for arguments.
+  args: {
+    first: v.number(),
+    second: v.string(),
+  },
+
+  // Function implementation.
+  handler: async (ctx, args) => {
+    // Read the database as many times as you need here.
+    // See https://docs.convex.dev/database/reading-data.
+    const documents = await ctx.db.query('tablename').collect();
+
+    // Arguments passed from the client are properties of the args object.
+    console.log(args.first, args.second);
+
+    // Write arbitrary JavaScript here: filter, aggregate, build derived data,
+    // remove non-public properties, or create new objects.
+    return documents;
+  },
+});
+```
+
+Using this query function in a React component looks like:
+
+```ts
+const data = useQuery(api.functions.myQueryFunction, {
+  first: 10,
+  second: 'hello',
+});
+```
+
+A mutation function looks like:
+
+```ts
+// functions.js
+import { mutation } from './_generated/server';
+import { v } from 'convex/values';
+
+export const myMutationFunction = mutation({
+  // Validators for arguments.
+  args: {
+    first: v.string(),
+    second: v.string(),
+  },
+
+  // Function implementation.
+  handler: async (ctx, args) => {
+    // Insert or modify documents in the database here.
+    // Mutations can also read from the database like queries.
+    // See https://docs.convex.dev/database/writing-data.
+    const message = { body: args.first, author: args.second };
+    const id = await ctx.db.insert('messages', message);
+
+    // Optionally, return a value from your mutation.
+    return await ctx.db.get(id);
+  },
+});
+```
+
+Using this mutation function in a React component looks like:
+
+```ts
+const mutation = useMutation(api.functions.myMutationFunction);
+function handleButtonPress() {
+  // fire and forget, the most common way to use mutations
+  mutation({ first: 'Hello!', second: 'me' });
+  // OR
+  // use the result once the mutation has completed
+  mutation({ first: 'Hello!', second: 'me' }).then((result) =>
+    console.log(result),
+  );
+}
+```
+
+Use the Convex CLI to push your functions to a deployment. See everything
+the Convex CLI can do by running `npx convex -h` in your project root
+directory. To learn more, launch the docs with `npx convex docs`.