Codex

.env.local.EXAMPLE

@@ -0,0 +1,3 @@
+
+# Local development database URL
+DATABASE_URL=file:./dev.db

.eslintignore

@@ -0,0 +1,12 @@
+node_modules/
+.next/
+funey.db
+schema.dump
+schema.sqlite.sql
+scripts/
+public/
+attached_assets/
+__tests__/
+**/.eslintrc.js
+jest.config.js
+jest.setup.js

.eslintrc.js

@@ -0,0 +1,93 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: './tsconfig.json',
+    tsconfigRootDir: __dirname,
+    ecmaVersion: 2020,
+    sourceType: 'module',
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+  plugins: ['@typescript-eslint', 'react', 'import'],
+  extends: [
+    'next/core-web-vitals',
+    'plugin:react/recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  env: {
+    browser: true,
+    es6: true,
+    node: true,
+  },
+  settings: {
+    'import/resolver': {
+      node: {
+        extensions: ['.js', '.jsx', '.ts', '.tsx'],
+        moduleDirectory: ['node_modules', 'src/'],
+      },
+    },
+  },
+  rules: {
+    semi: ['error', 'never'],
+    indent: ['error', 2],
+    'no-undef': 'off',
+    'react/jsx-filename-extension': [2, { extensions: ['.js', '.jsx', '.ts', '.tsx'] }],
+    'react/function-component-definition': [
+      2,
+      { namedComponents: 'arrow-function', unnamedComponents: 'arrow-function' },
+    ],
+    'react/react-in-jsx-scope': 'off',
+    'import/extensions': [
+      'error',
+      'always',
+      { js: 'never', jsx: 'never', ts: 'never', tsx: 'never' },
+    ],
+    'react/jsx-props-no-spreading': 'off',
+    'react/jsx-one-expression-per-line': 'off',
+    'import/no-cycle': 'off',
+    'import/named': 'off',
+    'import/no-unresolved': 'off',
+    'import/no-named-as-default': 'off',
+    'import/no-named-as-default-member': 'off',
+  },
+  overrides: [
+    {
+      files: ['**/*.ts', '**/*.tsx'],
+      rules: {
+        'react/prop-types': 'off',
+        'import/order': 'off',
+        // TypeScript files: relax stylistic rules; Prettier handles formatting
+        semi: 'off',
+        '@typescript-eslint/semi': 'off',
+        quotes: 'off',
+        '@typescript-eslint/quotes': 'off',
+        indent: 'off',
+        '@typescript-eslint/indent': 'off',
+        'comma-dangle': 'off',
+        '@typescript-eslint/comma-dangle': 'off',
+        'object-curly-newline': 'off',
+        '@typescript-eslint/object-curly-spacing': 'off',
+        'object-curly-spacing': 'off',
+        'function-paren-newline': 'off',
+        '@typescript-eslint/return-await': 'off',
+        'no-return-await': 'off',
+        'eol-last': 'off',
+        camelcase: 'off',
+        'no-param-reassign': 'off',
+        'no-console': 'off',
+        '@typescript-eslint/no-explicit-any': 'off',
+        'no-unused-vars': 'off',
+        '@typescript-eslint/no-unused-vars': 'off',
+        'no-multiple-empty-lines': 'off',
+        'max-len': 'off',
+        'react/jsx-wrap-multilines': 'off',
+        'react/jsx-indent': 'off',
+        'react/jsx-closing-tag-location': 'off',
+        'react/jsx-indent-props': 'off',
+        'no-useless-escape': 'off',
+      },
+    },
+  ],
+}

.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: Node.js CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x] # Test against relevant Node.js versions
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'yarn' # Cache yarn dependencies
+
+    - name: Install dependencies
+      run: yarn install --frozen-lockfile
+
+    - name: Run linters
+      run: yarn lint # Ensure code style and quality
+
+    # Prisma schemas should be generated during the build or test setup if needed
+    # The setup-test-db.js script checks for generated schemas
+    # Ensure build:prisma-schemas is run if schemas aren't checked in
+    # - name: Build Prisma Schemas if necessary
+    #   run: yarn build:prisma-schemas
+
+    - name: Build project
+      run: yarn build
+
+    - name: Run tests
+      run: yarn test
+      env:
+        # DATABASE_URL is set by the jest globalSetup script (setup-test-db.js)
+        # Add any other necessary env vars here if required by tests
+        CI: true # Often useful to indicate running in a CI environment

.gitignore

@@ -1,3 +1,9 @@
+
+.db/
+logfile
+.env.local
+funey.db
+
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 # dependencies
@@ -32,3 +38,4 @@ yarn-error.log*
 
 # vercel
 .vercel
+dev.db

.husky/pre-commit

@@ -0,0 +1,28 @@
+#!/usr/bin/env sh
+
+# Load NVM to ensure correct Node version and PATH
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"  # Source NVM script if it exists
+  # Optionally, add nvm use command here if you need a specific version
+  # nvm use
+elif [ -x "$(command -v brew)" ] && [ -s "$(brew --prefix nvm)/nvm.sh" ]; then
+  . "$(brew --prefix nvm)/nvm.sh" # Source NVM script if installed via Homebrew
+fi
+
+# Check if nvm command is available after sourcing
+if command -v nvm &> /dev/null; then
+  # Attempt to set the correct node version path if NVM is active
+  CURRENT_NODE_VERSION=$(nvm current)
+  NVM_NODE_PATH=$(nvm_find_nvmrc | xargs nvm_version_path 2>/dev/null || nvm_version_path "$CURRENT_NODE_VERSION" 2>/dev/null)
+
+  if [ -n "$NVM_NODE_PATH" ]; then
+    export PATH="$NVM_NODE_PATH/bin:$PATH"
+  fi
+else
+  echo "Warning: NVM script not found or NVM command not available. Falling back to system PATH."
+  # Fallback: Add local node_modules/.bin just in case NVM isn't used or fails
+  export PATH="$(cd "$(dirname "$0")/.." && pwd)/node_modules/.bin:$PATH"
+fi
+
+npx lint-staged

.prettierignore

@@ -0,0 +1,12 @@
+node_modules/
+.next/
+funey.db
+schema.dump
+schema.sqlite.sql
+scripts/
+public/
+attached_assets/
+__tests__/
+**/*.min.js
+*.lock
+yarn.lock

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "endOfLine": "lf"
+}

.replit

@@ -0,0 +1,20 @@
+modules = ["nodejs-20"]
+[workflows]
+runButton = "Development"
+
+[[workflows.workflow]]
+name = "Development"
+author = 41832294
+mode = "sequential"
+
+[[workflows.workflow.tasks]]
+task = "shell.exec"
+args = "yarn dev"
+
+[[ports]]
+localPort = 3000
+externalPort = 80
+
+[nix]
+packages = ["postgresql", "sqlite"]
+channel = "stable-24_05"

CONTRIBUTING.md

@@ -4,72 +4,80 @@ Thank you for your interest in contributing to Funey!
 
 ## Getting Started
 
-1. Fork the repository and clone your fork:
+1. Fork and clone the repository:
    ```bash
-   git clone git@github.com:<your-username>/funey.git
+   git clone https://github.com/<your-username>/funey.git
    cd funey
    ```
 2. Install dependencies:
    ```bash
    yarn install
    ```
-3. Set up the database:
-   - Create a new Postgres database.
-   - Load the schema:
-     ```bash
-     psql <dbname> < schema.dump
-     ```
-4. Create a `.env.local` file in the project root and define your database connection:
+3. Configure environment:
+   1. Copy the example env file and edit:
+      ```bash
+      cp .env.local.EXAMPLE .env.local
+      ```
+   2. In `.env.local`, set `DATABASE_URL`:
+      - For local SQLite development:
+        ```ini
+        DATABASE_URL=file:./dev.db
+        ```
+      - For PostgreSQL development:
+        ```ini
+        DATABASE_URL=postgresql://user:pass@localhost:5432/funey
+        ```
+4. Initialize the database:
    ```bash
-   PGHOST=localhost
-   PGPORT=5432
-   PGPASS=<your_password>
-   DB=<your_database_name>
+   yarn build:prisma-schemas
+   yarn db:clean
    ```
-5. Start the development server:
+5. Start development server:
    ```bash
    yarn dev
    ```
 
-Open http://localhost:3000 in your browser to verify everything is working.
+## Code Style and Quality
 
-## Code Style
+- Indentation: 4 spaces
+- Strings: double quotes
+- Semicolons: follow existing style
+- Use functional React components
+- Organize pages under `/pages`
+- Keep shared components/utilities in `/src`
+- Update `schema.dump` after DB changes
 
-- Indentation: 2 spaces
-- Strings: single quotes in JS; double quotes in JSX attributes
-- No semicolons at the end of statements
-- Functional React components and Next.js conventions
-- Organize pages under `/pages`; shared components or utilities under `/src`
-- After any DB schema change, regenerate `schema.dump`
+**Automated Checks:**
+
+This project uses `eslint` and `prettier` for code linting and formatting. These checks are automatically run on staged files before each commit using `husky` and `lint-staged`.
+
+- Ensure your code passes `yarn lint` before pushing.
+- Commits may be blocked if linting or formatting errors are found.
 
 ## Commit Messages
 
 Follow [Conventional Commits](https://www.conventionalcommits.org/):
-- `feat(scope): description` – a new feature
-- `fix(scope): description` – a bug fix
-- `docs(scope): description` – documentation only changes
-- `style(scope): description` – formatting, missing semicolons, etc
-- `refactor(scope): description` – code change that neither fixes a bug nor adds a feature
-- `test(scope): description` – adding or updating tests
-- `chore(scope): description` – changes to build process or auxiliary tools
-
-## Pull Requests
 
-- Base your PR against the `main` branch
-- Include a clear description of your changes
-- Link to any relevant issues
-- Add screenshots or GIFs for UI changes
+- `feat:` new feature
+- `fix:` bug fix
+- `docs:` documentation changes
+- `style:` formatting changes
+- `refactor:` code restructuring
+- `test:` adding/updating tests
+- `chore:` build process changes
 
-## Issues
+## Pull Requests
 
-Please use GitHub Issues to report bugs or suggest features.
+- Base against `main` branch
+- Include clear description
+- Link relevant issues
+- Add screenshots for UI changes
 
 ## Testing
 
-- There are currently no automated tests.
-- Manually verify your changes by running `yarn dev` and checking the app.
-
-## Linting
-
-- You can run `npx next lint` to check for lint errors.
-  (Add an ESLint config if needed.)
+- Manually verify changes with `yarn dev`
+- Run unit tests locally:
+  ```bash
+  yarn test
+  ```
+- **Automated CI:** All pull requests and pushes to `main` automatically trigger a GitHub Actions workflow. This workflow runs linters (`yarn lint`), builds the project (`yarn build`), and executes the test suite (`yarn test`) across multiple Node.js versions. Ensure these checks pass before merging.