Skip to content

[TASK] Clean up project architecture - flatten renderer and rename core #152

@codewizdave

Description

@codewizdave

Description

Clean up the project structure to make it more intuitive and maintainable.

Current Issues

1. Nested renderer folder

src/renderer/src/components  ❌

Should be:

src/renderer/components     ✅

2. Routes outside renderer

src/routes/ is at root level

Should be:

src/renderer/src/routes/    (moved into renderer)

3. Misleading "core" folder name

src/core/ contains main-process-only code

The name "core" implies shared code, but it's actually main-process specific.

Should be renamed to something clearer:

  • src/server/ (if it runs on main)
  • src/main-core/ (explicit)

4. Duplicate migrations folders

src/db/migrations/
src/core/db/migrations/

Proposed Structure

src/
├── main/              # Electron main process
├── preload/           # Preload scripts
├── renderer/          # React app (flattened)
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── routes/
│   │   ├── hooks/
│   │   ├── stores/
│   │   └── ...
│   └── index.html
├── server/            # Renamed from core (main process code)
│   ├── db/
│   ├── ipc/
│   └── lib/
└── routes/            # DELETE - move to renderer/src/routes/

Requirements

  • Flatten src/renderer/src/ to src/renderer/
  • Move src/routes/ to src/renderer/src/routes/
  • Rename src/core/ to src/server/
  • Delete duplicate src/db/ (keep src/core/db/)
  • Update all import paths in the codebase
  • Update electron.vite.config.ts
  • Update tsconfig.json paths
  • Update any references in package.json scripts

Priority

  • priority:medium

Effort

  • effort:l

Notes

  • This is a refactor only, no functionality changes
  • Will require updating import paths across many files

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions