cortex-claude 0.3.0__tar.gz → 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/.gitignore +2 -0
  2. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/PKG-INFO +29 -4
  3. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/README.md +28 -3
  4. cortex_claude-0.4.0/docs/example-ui.gif +0 -0
  5. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/pyproject.toml +1 -1
  6. cortex_claude-0.4.0/src/cortex_claude/__init__.py +1 -0
  7. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/__main__.py +4 -0
  8. cortex_claude-0.4.0/src/cortex_claude/web/frontend/.gitignore +24 -0
  9. cortex_claude-0.4.0/src/cortex_claude/web/frontend/README.md +73 -0
  10. cortex_claude-0.4.0/src/cortex_claude/web/frontend/eslint.config.js +22 -0
  11. cortex_claude-0.4.0/src/cortex_claude/web/frontend/index.html +13 -0
  12. cortex_claude-0.4.0/src/cortex_claude/web/frontend/package-lock.json +3139 -0
  13. cortex_claude-0.4.0/src/cortex_claude/web/frontend/package.json +38 -0
  14. cortex_claude-0.4.0/src/cortex_claude/web/frontend/public/favicon.svg +1 -0
  15. cortex_claude-0.4.0/src/cortex_claude/web/frontend/public/icons.svg +24 -0
  16. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/App.tsx +122 -0
  17. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/assets/hero.png +0 -0
  18. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/assets/vite.svg +1 -0
  19. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/components/DetailPanel.tsx +226 -0
  20. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/components/GraphView.tsx +349 -0
  21. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/components/Header.tsx +40 -0
  22. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/components/Sidebar.tsx +276 -0
  23. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/index.css +32 -0
  24. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/lib/api.ts +63 -0
  25. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/lib/cn.ts +6 -0
  26. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/main.tsx +10 -0
  27. cortex_claude-0.4.0/src/cortex_claude/web/frontend/src/vite-env.d.ts +6 -0
  28. cortex_claude-0.4.0/src/cortex_claude/web/frontend/tsconfig.app.json +25 -0
  29. cortex_claude-0.4.0/src/cortex_claude/web/frontend/tsconfig.json +7 -0
  30. cortex_claude-0.4.0/src/cortex_claude/web/frontend/tsconfig.node.json +24 -0
  31. cortex_claude-0.4.0/src/cortex_claude/web/frontend/vite.config.ts +22 -0
  32. cortex_claude-0.4.0/src/cortex_claude/web/server.py +287 -0
  33. cortex_claude-0.4.0/src/cortex_claude/web/static/assets/index-BiPLkRYh.css +2 -0
  34. cortex_claude-0.4.0/src/cortex_claude/web/static/assets/index-Cg9ibm7y.js +329 -0
  35. cortex_claude-0.4.0/src/cortex_claude/web/static/favicon.svg +1 -0
  36. cortex_claude-0.4.0/src/cortex_claude/web/static/icons.svg +24 -0
  37. cortex_claude-0.4.0/src/cortex_claude/web/static/index.html +14 -0
  38. cortex_claude-0.4.0/tests/unit/__init__.py +0 -0
  39. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/uv.lock +1 -1
  40. cortex_claude-0.3.0/src/cortex_claude/__init__.py +0 -1
  41. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/.claude/hooks/post-tool-use.sh +0 -0
  42. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/.claude/hooks/session-start.sh +0 -0
  43. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/.github/workflows/ci.yml +0 -0
  44. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/.github/workflows/publish.yml +0 -0
  45. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/ARCHITECTURE.md +0 -0
  46. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/CONTRIBUTING.md +0 -0
  47. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/LICENSE +0 -0
  48. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/docs/logo.png +0 -0
  49. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/examples/config.json +0 -0
  50. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/examples/mcp-global.json +0 -0
  51. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/examples/mcp-project.json +0 -0
  52. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/scripts/benchmark.py +0 -0
  53. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/scripts/demo.py +0 -0
  54. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/core/__init__.py +0 -0
  55. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/core/decay.py +0 -0
  56. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/core/engine.py +0 -0
  57. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/core/privacy.py +0 -0
  58. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/core/scope_manager.py +0 -0
  59. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/core/token_budget.py +0 -0
  60. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/daemon.py +0 -0
  61. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/embeddings/__init__.py +0 -0
  62. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/embeddings/engine.py +0 -0
  63. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/embeddings/tokenizer.py +0 -0
  64. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/facts/__init__.py +0 -0
  65. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/facts/claude_extract.py +0 -0
  66. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/facts/extractor.py +0 -0
  67. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/facts/normalizer.py +0 -0
  68. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/facts/patterns.py +0 -0
  69. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/facts/spacy_extract.py +0 -0
  70. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/models/__init__.py +0 -0
  71. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/models/fact.py +0 -0
  72. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/models/memory.py +0 -0
  73. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/models/scope.py +0 -0
  74. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/pipeline/__init__.py +0 -0
  75. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/__init__.py +0 -0
  76. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/app.py +0 -0
  77. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/config.py +0 -0
  78. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/__init__.py +0 -0
  79. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/facts.py +0 -0
  80. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/forget.py +0 -0
  81. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/recall.py +0 -0
  82. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/save.py +0 -0
  83. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/scopes.py +0 -0
  84. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/status.py +0 -0
  85. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/server/tools/traverse.py +0 -0
  86. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/setup.py +0 -0
  87. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/storage/__init__.py +0 -0
  88. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/storage/database.py +0 -0
  89. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/storage/fact_repo.py +0 -0
  90. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/storage/memory_repo.py +0 -0
  91. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/storage/migrations.py +0 -0
  92. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/summarizer/__init__.py +0 -0
  93. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/summarizer/extractive.py +0 -0
  94. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/src/cortex_claude/summarizer/scoring.py +0 -0
  95. {cortex_claude-0.3.0/tests → cortex_claude-0.4.0/src/cortex_claude/web}/__init__.py +0 -0
  96. {cortex_claude-0.3.0/tests/integration → cortex_claude-0.4.0/tests}/__init__.py +0 -0
  97. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/conftest.py +0 -0
  98. {cortex_claude-0.3.0/tests/unit → cortex_claude-0.4.0/tests/integration}/__init__.py +0 -0
  99. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_forget_scopes_status.py +0 -0
  100. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_fts_and_decay.py +0 -0
  101. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_graph_traversal.py +0 -0
  102. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_privacy.py +0 -0
  103. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_progressive_recall.py +0 -0
  104. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_save_recall.py +0 -0
  105. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/integration/test_storage.py +0 -0
  106. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_claude_extract.py +0 -0
  107. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_config.py +0 -0
  108. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_decay.py +0 -0
  109. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_facts.py +0 -0
  110. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_normalizer.py +0 -0
  111. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_patterns.py +0 -0
  112. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_privacy.py +0 -0
  113. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_scope_manager.py +0 -0
  114. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_summarizer.py +0 -0
  115. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_token_budget.py +0 -0
  116. {cortex_claude-0.3.0 → cortex_claude-0.4.0}/tests/unit/test_tokenizer.py +0 -0
@@ -18,3 +18,5 @@ build/
18
18
  *.onnx
19
19
  .env
20
20
  .env.*
21
+ node_modules/
22
+ src/cortex_claude/web/frontend/node_modules/
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cortex-claude
3
- Version: 0.3.0
3
+ Version: 0.4.0
4
4
  Summary: Local-first, token-efficient memory system for Claude Code via MCP
5
5
  Project-URL: Homepage, https://github.com/rafaelaugusto/cortex-claude
6
6
  Project-URL: Repository, https://github.com/rafaelaugusto/cortex-claude
@@ -51,7 +51,7 @@ Description-Content-Type: text/markdown
51
51
  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License">
52
52
  </a>
53
53
  <a href="pyproject.toml">
54
- <img src="https://img.shields.io/badge/version-0.3.0-green.svg" alt="Version">
54
+ <img src="https://img.shields.io/badge/version-0.4.0-green.svg" alt="Version">
55
55
  </a>
56
56
  <a href="pyproject.toml">
57
57
  <img src="https://img.shields.io/badge/python-%3E%3D3.11-brightgreen.svg" alt="Python">
@@ -62,6 +62,7 @@ Description-Content-Type: text/markdown
62
62
  <a href="#quick-start">Quick Start</a> &bull;
63
63
  <a href="#how-it-works">How It Works</a> &bull;
64
64
  <a href="#tools">Tools</a> &bull;
65
+ <a href="#web-dashboard">Dashboard</a> &bull;
65
66
  <a href="#configuration">Configuration</a> &bull;
66
67
  <a href="#benchmarks">Benchmarks</a> &bull;
67
68
  <a href="#development">Development</a>
@@ -71,6 +72,14 @@ Description-Content-Type: text/markdown
71
72
  Cortex gives Claude Code persistent memory through a local MCP server. Unlike solutions that dump everything into context, Cortex uses <strong>progressive recall</strong> &mdash; a 3-layer retrieval system that returns only what's relevant, using the minimum tokens needed.
72
73
  </p>
73
74
 
75
+ <br>
76
+
77
+ <p align="center">
78
+ <img src="docs/example-ui.gif" alt="Cortex Claude Dashboard" width="800">
79
+ </p>
80
+
81
+ <p align="center"><em>Interactive knowledge graph &mdash; explore entities, facts, and memories visually.</em></p>
82
+
74
83
  ---
75
84
 
76
85
  ## The Problem
@@ -264,6 +273,22 @@ Cortex strips everything between `<private>...</private>` before saving. Works i
264
273
 
265
274
  Combines **vector similarity** (semantic meaning) with **FTS5** (exact keyword match) for best recall. FTS5 synced automatically via SQLite triggers.
266
275
 
276
+ ### Web Dashboard
277
+
278
+ Interactive knowledge graph visualization and memory browser:
279
+
280
+ ```bash
281
+ cortex-claude web
282
+ # Opens at http://localhost:37800
283
+ ```
284
+
285
+ Features:
286
+ - **Interactive knowledge graph** &mdash; nodes are entities, edges are relations. Click a node to see all its facts and related memories.
287
+ - **Memory browser** &mdash; browse all memories with search, tags, scope, and decay score.
288
+ - **Facts list** &mdash; all extracted triplets, click to focus on the graph node.
289
+ - **Live stats** &mdash; memory count, fact count, scopes, storage size.
290
+ - **Dark theme** &mdash; designed for developers.
291
+
267
292
  ---
268
293
 
269
294
  ## Cortex vs Traditional Memory (claude-mem, etc.)
@@ -284,7 +309,7 @@ Most memory solutions for AI assistants follow the same pattern: capture observa
284
309
  | **Auto-capture** | All tool calls via hooks | All tools (Bash, Read, Edit, Write, Grep, Glob, Agent, MCP, Web) via hooks + daemon |
285
310
  | **Session injection** | Full context dump on start | Lightweight facts injection via direct SQLite (<1s) |
286
311
  | **Dependencies** | Node.js, Bun, Chroma vector DB | Python + SQLite only (zero external services) |
287
- | **Web UI** | Viewer on localhost:37777 | CLI only (planned) |
312
+ | **Web UI** | Viewer on localhost:37777 | Interactive graph dashboard on localhost:37800 |
288
313
 
289
314
  ### Where Cortex wins
290
315
 
@@ -298,7 +323,7 @@ Most memory solutions for AI assistants follow the same pattern: capture observa
298
323
  ### Where claude-mem wins
299
324
 
300
325
  - **Broader auto-capture** &mdash; captures all tool calls including MCP tools from third-party servers.
301
- - **Web viewer** &mdash; real-time memory browser at localhost:37777.
326
+ - **Web viewer** &mdash; real-time memory browser (Cortex has an interactive graph dashboard, but claude-mem's is more mature).
302
327
  - **One-command install** &mdash; `npx claude-mem install` vs manual MCP config.
303
328
  - **Larger community** &mdash; more stars, Discord, extensive documentation site.
304
329
 
@@ -13,7 +13,7 @@
13
13
  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License">
14
14
  </a>
15
15
  <a href="pyproject.toml">
16
- <img src="https://img.shields.io/badge/version-0.3.0-green.svg" alt="Version">
16
+ <img src="https://img.shields.io/badge/version-0.4.0-green.svg" alt="Version">
17
17
  </a>
18
18
  <a href="pyproject.toml">
19
19
  <img src="https://img.shields.io/badge/python-%3E%3D3.11-brightgreen.svg" alt="Python">
@@ -24,6 +24,7 @@
24
24
  <a href="#quick-start">Quick Start</a> &bull;
25
25
  <a href="#how-it-works">How It Works</a> &bull;
26
26
  <a href="#tools">Tools</a> &bull;
27
+ <a href="#web-dashboard">Dashboard</a> &bull;
27
28
  <a href="#configuration">Configuration</a> &bull;
28
29
  <a href="#benchmarks">Benchmarks</a> &bull;
29
30
  <a href="#development">Development</a>
@@ -33,6 +34,14 @@
33
34
  Cortex gives Claude Code persistent memory through a local MCP server. Unlike solutions that dump everything into context, Cortex uses <strong>progressive recall</strong> &mdash; a 3-layer retrieval system that returns only what's relevant, using the minimum tokens needed.
34
35
  </p>
35
36
 
37
+ <br>
38
+
39
+ <p align="center">
40
+ <img src="docs/example-ui.gif" alt="Cortex Claude Dashboard" width="800">
41
+ </p>
42
+
43
+ <p align="center"><em>Interactive knowledge graph &mdash; explore entities, facts, and memories visually.</em></p>
44
+
36
45
  ---
37
46
 
38
47
  ## The Problem
@@ -226,6 +235,22 @@ Cortex strips everything between `<private>...</private>` before saving. Works i
226
235
 
227
236
  Combines **vector similarity** (semantic meaning) with **FTS5** (exact keyword match) for best recall. FTS5 synced automatically via SQLite triggers.
228
237
 
238
+ ### Web Dashboard
239
+
240
+ Interactive knowledge graph visualization and memory browser:
241
+
242
+ ```bash
243
+ cortex-claude web
244
+ # Opens at http://localhost:37800
245
+ ```
246
+
247
+ Features:
248
+ - **Interactive knowledge graph** &mdash; nodes are entities, edges are relations. Click a node to see all its facts and related memories.
249
+ - **Memory browser** &mdash; browse all memories with search, tags, scope, and decay score.
250
+ - **Facts list** &mdash; all extracted triplets, click to focus on the graph node.
251
+ - **Live stats** &mdash; memory count, fact count, scopes, storage size.
252
+ - **Dark theme** &mdash; designed for developers.
253
+
229
254
  ---
230
255
 
231
256
  ## Cortex vs Traditional Memory (claude-mem, etc.)
@@ -246,7 +271,7 @@ Most memory solutions for AI assistants follow the same pattern: capture observa
246
271
  | **Auto-capture** | All tool calls via hooks | All tools (Bash, Read, Edit, Write, Grep, Glob, Agent, MCP, Web) via hooks + daemon |
247
272
  | **Session injection** | Full context dump on start | Lightweight facts injection via direct SQLite (<1s) |
248
273
  | **Dependencies** | Node.js, Bun, Chroma vector DB | Python + SQLite only (zero external services) |
249
- | **Web UI** | Viewer on localhost:37777 | CLI only (planned) |
274
+ | **Web UI** | Viewer on localhost:37777 | Interactive graph dashboard on localhost:37800 |
250
275
 
251
276
  ### Where Cortex wins
252
277
 
@@ -260,7 +285,7 @@ Most memory solutions for AI assistants follow the same pattern: capture observa
260
285
  ### Where claude-mem wins
261
286
 
262
287
  - **Broader auto-capture** &mdash; captures all tool calls including MCP tools from third-party servers.
263
- - **Web viewer** &mdash; real-time memory browser at localhost:37777.
288
+ - **Web viewer** &mdash; real-time memory browser (Cortex has an interactive graph dashboard, but claude-mem's is more mature).
264
289
  - **One-command install** &mdash; `npx claude-mem install` vs manual MCP config.
265
290
  - **Larger community** &mdash; more stars, Discord, extensive documentation site.
266
291
 
Binary file
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "cortex-claude"
3
- version = "0.3.0"
3
+ version = "0.4.0"
4
4
  description = "Local-first, token-efficient memory system for Claude Code via MCP"
5
5
  readme = "README.md"
6
6
  license = { text = "MIT" }
@@ -0,0 +1 @@
1
+ __version__ = "0.4.0"
@@ -9,6 +9,10 @@ def main() -> None:
9
9
  run_setup()
10
10
  elif cmd == "daemon":
11
11
  _run_daemon()
12
+ elif cmd == "web":
13
+ port = int(sys.argv[2]) if len(sys.argv) > 2 else 37800
14
+ from cortex_claude.web.server import run_web
15
+ run_web(port=port)
12
16
  else:
13
17
  from cortex_claude.server.app import mcp, _init_engine
14
18
  _init_engine()
@@ -0,0 +1,24 @@
1
+ # Logs
2
+ logs
3
+ *.log
4
+ npm-debug.log*
5
+ yarn-debug.log*
6
+ yarn-error.log*
7
+ pnpm-debug.log*
8
+ lerna-debug.log*
9
+
10
+ node_modules
11
+ dist
12
+ dist-ssr
13
+ *.local
14
+
15
+ # Editor directories and files
16
+ .vscode/*
17
+ !.vscode/extensions.json
18
+ .idea
19
+ .DS_Store
20
+ *.suo
21
+ *.ntvs*
22
+ *.njsproj
23
+ *.sln
24
+ *.sw?
@@ -0,0 +1,73 @@
1
+ # React + TypeScript + Vite
2
+
3
+ This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
4
+
5
+ Currently, two official plugins are available:
6
+
7
+ - [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
8
+ - [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
9
+
10
+ ## React Compiler
11
+
12
+ The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
13
+
14
+ ## Expanding the ESLint configuration
15
+
16
+ If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
17
+
18
+ ```js
19
+ export default defineConfig([
20
+ globalIgnores(['dist']),
21
+ {
22
+ files: ['**/*.{ts,tsx}'],
23
+ extends: [
24
+ // Other configs...
25
+
26
+ // Remove tseslint.configs.recommended and replace with this
27
+ tseslint.configs.recommendedTypeChecked,
28
+ // Alternatively, use this for stricter rules
29
+ tseslint.configs.strictTypeChecked,
30
+ // Optionally, add this for stylistic rules
31
+ tseslint.configs.stylisticTypeChecked,
32
+
33
+ // Other configs...
34
+ ],
35
+ languageOptions: {
36
+ parserOptions: {
37
+ project: ['./tsconfig.node.json', './tsconfig.app.json'],
38
+ tsconfigRootDir: import.meta.dirname,
39
+ },
40
+ // other options...
41
+ },
42
+ },
43
+ ])
44
+ ```
45
+
46
+ You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
47
+
48
+ ```js
49
+ // eslint.config.js
50
+ import reactX from 'eslint-plugin-react-x'
51
+ import reactDom from 'eslint-plugin-react-dom'
52
+
53
+ export default defineConfig([
54
+ globalIgnores(['dist']),
55
+ {
56
+ files: ['**/*.{ts,tsx}'],
57
+ extends: [
58
+ // Other configs...
59
+ // Enable lint rules for React
60
+ reactX.configs['recommended-typescript'],
61
+ // Enable lint rules for React DOM
62
+ reactDom.configs.recommended,
63
+ ],
64
+ languageOptions: {
65
+ parserOptions: {
66
+ project: ['./tsconfig.node.json', './tsconfig.app.json'],
67
+ tsconfigRootDir: import.meta.dirname,
68
+ },
69
+ // other options...
70
+ },
71
+ },
72
+ ])
73
+ ```
@@ -0,0 +1,22 @@
1
+ import js from '@eslint/js'
2
+ import globals from 'globals'
3
+ import reactHooks from 'eslint-plugin-react-hooks'
4
+ import reactRefresh from 'eslint-plugin-react-refresh'
5
+ import tseslint from 'typescript-eslint'
6
+ import { defineConfig, globalIgnores } from 'eslint/config'
7
+
8
+ export default defineConfig([
9
+ globalIgnores(['dist']),
10
+ {
11
+ files: ['**/*.{ts,tsx}'],
12
+ extends: [
13
+ js.configs.recommended,
14
+ tseslint.configs.recommended,
15
+ reactHooks.configs.flat.recommended,
16
+ reactRefresh.configs.vite,
17
+ ],
18
+ languageOptions: {
19
+ globals: globals.browser,
20
+ },
21
+ },
22
+ ])
@@ -0,0 +1,13 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
6
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
7
+ <title>frontend</title>
8
+ </head>
9
+ <body>
10
+ <div id="root"></div>
11
+ <script type="module" src="/src/main.tsx"></script>
12
+ </body>
13
+ </html>