Install Vercel Web Analytics

.dockerignore

@@ -0,0 +1,15 @@
+.git
+.gitignore
+README.md
+.dockerignore
+docker-compose.prod.yml
+node_modules
+npm-debug.log
+*.log
+.env
+.env.local
+.docs
+.husky
+scripts/
+public/
+docs/

.env

@@ -0,0 +1,13 @@
+# ReactPress — copy to .env and run `pnpm init` to sync from .reactpress/config.json
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_USER=reactpress
+DB_PASSWD=reactpress
+DB_DATABASE=reactpress
+
+
+# Client Config
+CLIENT_SITE_URL=http://localhost:3001
+
+# Server Config
+SERVER_SITE_URL=http://localhost:3002

.eslintignore

@@ -0,0 +1,6 @@
+node_modules
+**/.next/**
+**/_next/**
+**/dist/**
+.eslintrc.js
+dist

.eslintrc.js

@@ -0,0 +1,54 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint', 'react-hooks', 'simple-import-sort', 'prettier'],
+  extends: [
+    'eslint:recommended',
+    'plugin:react/recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  overrides: [
+    {
+      files: ['**/*.{ts,tsx,js,jsx}'],
+      parserOptions: {
+        project: ['./client/tsconfig.json'],
+        tsconfigRootDir: __dirname,
+        sourceType: 'module',
+      },
+    },
+  ],
+  settings: {
+    react: {
+      version: '17.0',
+    },
+  },
+  env: {
+    es6: true,
+    browser: true,
+    node: true,
+  },
+  rules: {
+    'func-names': 0,
+    'no-shadow': 0,
+    '@typescript-eslint/no-shadow': 0,
+    '@typescript-eslint/explicit-function-return-type': 0,
+    '@typescript-eslint/no-unused-vars': [0, { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/no-use-before-define': 0,
+    '@typescript-eslint/ban-ts-ignore': 0,
+    '@typescript-eslint/no-empty-function': 0,
+    '@typescript-eslint/ban-ts-comment': 0,
+    '@typescript-eslint/no-var-requires': 0,
+    '@typescript-eslint/no-explicit-any': 0,
+    '@typescript-eslint/no-this-alias': 0,
+    '@typescript-eslint/explicit-module-boundary-types': 0,
+    '@typescript-eslint/ban-types': 0,
+    'react-hooks/rules-of-hooks': 2,
+    'react-hooks/exhaustive-deps': 2,
+    'react/prop-types': 0,
+    'react/react-in-jsx-scope': 0,
+    'prettier/prettier': 'error',
+    'simple-import-sort/imports': 'error',
+    'simple-import-sort/exports': 'error',
+  },
+  ignorePatterns: ['dist/', 'node_modules', 'scripts'],
+};

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,56 @@
+---
+name: Bug report
+about: Report something that is broken
+title: '[Bug] '
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+
+A clear, concise description of what went wrong.
+
+**Component**
+
+- [ ] CLI (`reactpress`)
+- [ ] Server (API)
+- [ ] Admin (web)
+- [ ] Toolkit
+- [ ] Theme / templates
+- [ ] Docs site
+- [ ] Other
+
+**To reproduce**
+
+1.
+2.
+3.
+
+**Expected behavior**
+
+
+**Actual behavior**
+
+
+**Environment**
+
+| | |
+|---|---|
+| ReactPress version | <!-- e.g. `@fecommunity/reactpress@3.1.0` or git commit --> |
+| Node.js | <!-- e.g. 20.x --> |
+| OS | <!-- e.g. macOS 14 --> |
+| Setup | <!-- local `pnpm dev` / Docker / production PM2 --> |
+
+**Logs / errors**
+
+```
+Paste relevant terminal output or stack traces
+```
+
+**Screenshots**
+
+If UI-related, attach screenshots or screen recordings.
+
+**Additional context**
+
+Database mode (Docker MySQL / external), custom `.env` flags, nginx — only if relevant.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,24 @@
+blank_issues_enabled: false
+
+contact_links:
+  - name: Questions & Help
+    url: https://github.com/fecommunity/reactpress/discussions/categories/q-a
+    about: Ask setup questions or share tips — prefer Discussions over Issues
+  - name: ReactPress Docs
+    url: https://reactpress-docs.vercel.app/
+    about: Official ReactPress documentation
+  - name: Theme starter Q&A
+    url: https://github.com/fecommunity/reactpress-theme-starter/discussions/categories/q-a
+    about: Theme development and customization — starter repo Discussions
+  - name: Browse existing issues
+    url: https://github.com/fecommunity/reactpress/issues
+    about: Search open issues before filing a duplicate (CMS, API, CLI, admin, toolkit)
+  - name: Proposed roadmap issues
+    url: https://github.com/fecommunity/reactpress/blob/master/docs/proposed-reactpress-upstream-issues.md
+    about: Curated core and community issues you can pick up
+  - name: Contributing guide
+    url: https://github.com/fecommunity/reactpress/blob/master/CONTRIBUTING.md
+    about: Setup, PR process, and project structure
+  - name: Security report
+    url: https://github.com/fecommunity/reactpress/blob/master/SECURITY.md
+    about: Report vulnerabilities privately — do not use public issues

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature request
+about: Suggest a new capability or improvement
+title: '[Feature] '
+labels: enhancement
+assignees: ''
+---
+
+<!-- Core areas: Plugin · Theme · Desktop · Docs · Integration -->
+
+**Is your feature request related to a problem? Please describe.**
+
+What pain point does this solve? Who is affected (site owner, theme author, integrator, contributor)?
+
+**Describe the solution you'd like**
+
+What should exist when this is done? CLI commands, API, admin UI, docs — be specific if you can.
+
+**Describe alternatives you've considered**
+
+Other approaches you rejected and why.
+
+**Additional context**
+
+- **Area:** Plugin / Theme / Desktop / Docs / Integration / Other
+- **Related epic:** <!-- e.g. links to an existing issue or docs/proposed-reactpress-upstream-issues.md #3 -->
+- Screenshots, sketches, or links — optional

.github/ISSUE_TEMPLATE/feedback.md

@@ -0,0 +1,32 @@
+---
+name: Feedback & suggestions
+about: Share product feedback, UX ideas, or site-operator suggestions (not a code bug)
+title: '[Feedback] '
+labels: question
+assignees: ''
+---
+
+**What is your feedback about?**
+
+- [ ] Admin UX
+- [ ] CLI / developer experience
+- [ ] Theme / visitor site
+- [ ] Notifications & alerts
+- [ ] Documentation
+- [ ] Other
+
+**Current experience**
+
+What happens today that feels wrong, missing, or confusing?
+
+**Suggested improvement**
+
+What would better look like? Examples or references welcome.
+
+**Who is this for?**
+
+<!-- e.g. first-time installer, theme author, content editor, self-hosted ops -->
+
+**Additional context**
+
+Version, screenshot, or workflow — optional. For **security** issues use [SECURITY.md](https://github.com/fecommunity/reactpress/blob/master/SECURITY.md) instead.

.github/ISSUE_TEMPLATE/help_wanted.md

@@ -0,0 +1,37 @@
+---
+name: Help wanted
+about: Claim a community task or propose a small scoped contribution
+title: '[Help wanted] '
+labels: help wanted
+assignees: ''
+---
+
+<!-- Pick from docs/proposed-reactpress-upstream-issues.md (#5–#9) or describe your own scoped task. -->
+
+**What do you want to work on?**
+
+Link an existing epic/checkbox or summarize the task in one sentence.
+
+**Problem (why this helps)**
+
+Who benefits and what is missing today?
+
+**Your plan**
+
+- [ ] Scope of this PR (one checkbox / one example / one event / one doc page)
+- [ ] Files or packages you expect to touch
+- [ ] Out of scope for this PR
+
+**Skills**
+
+<!-- e.g. NestJS, React admin, Docusaurus, Next.js theme -->
+
+**Describe alternatives you've considered**
+
+N/A if you are implementing an agreed task from the roadmap doc.
+
+**Additional context**
+
+- **Claiming a roadmap item?** Comment `I'll take: …` on the parent epic before opening the PR.
+- **First contribution?** See [CONTRIBUTING.md](https://github.com/fecommunity/reactpress/blob/master/CONTRIBUTING.md)
+- **Blocked on design?** Open as draft and ask early.

.github/PULL_REQUEST_TEMPLATE/pr.md

@@ -0,0 +1,46 @@
+# Pull Request Template
+
+## Description
+
+📋 Please include a summary of the changes made in this pull request (PR). Provide any context necessary for the reviewer to understand the changes.
+
+## Related Issue
+
+🔗 Fixes # (issue number)
+
+If this PR resolves an issue, please include the issue number prefixed with `#`.
+
+## Type of Change
+
+🏷️ Please select the type of change this PR introduces:
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] This change requires a documentation update
+- [ ] Refactoring (no functional changes, no api changes)
+- [ ] CI/CD related changes
+- [ ] Other (please describe)
+
+## Checklist
+
+✅ Please tick all the boxes that are completed:
+
+- [ ] I have tested this code locally and it passes all tests.
+- [ ] I have updated the documentation where necessary.
+- [ ] All new and existing tests passed.
+- [ ] My code follows the style guidelines of this project.
+- [ ] I have added tests to cover my changes.
+- [ ] All new and existing linting passes.
+
+## Screenshots (if applicable)
+
+📷 If this PR includes visual changes, please provide screenshots to help the reviewer understand the changes.
+
+## Additional Context
+
+💡 Add any other context or screenshots about the pull request here. This section is optional but can be useful for providing additional clarity.
+
+---
+
+By submitting this pull request, I confirm that my contribution is made under the terms of the [project's license](LICENSE).