How to contribute and run server locally?

[tasnim0tantawi]

Support guidelines

• I've read the support guidelines

I've found a bug and checked that ...

• ... the documentation does not mention anything about my problem
• ... there are no open or closed issues that are related to my problem
• ... it's definitely a Firefly III issue, not me

Description

I have tried to run server locally to contribute. I keep getting a Vite related error.
The Docs mention that the project is not updatable from github repo. Contributing page is missing.
What to do? I want to contribute.

Debug information

The project runs fine when I download zip file in docs.

Expected behaviour

To be able to clone project normally.

Steps to reproduce

1. Clone the project
2. Try to run it following docs steps.
   https://docs.firefly-iii.org/how-to/firefly-iii/installation/self-managed/
3. An error related to JS files will appear.

Additional info

I know that it runs fine if I download the .zip file or I run Docker image, but I want to clone it to contribute. Please help.

[JC5]

Hey!

great to hear that you want to contribute. What do you consider your knowledge base in regards to npm and vite?

[tasnim0tantawi]

I have experience with Vite and React (still figuring out Vue and project structure).
I'm not sure, should I add vite manifest and what's missing manually?
Thanks so much for your respond ! @JC5

[JC5]

The package.json in the root of the Firefly III directory refers to two workspaces. You can use either --workspace=v1 or --workspace=v2 to issue commands. Since you mention Vite, I expect you need --workspace=v2. Vite is only used in the new layout.

[tasnim0tantawi]

I'm not sure, but I always get the error mentioned in this discussion https://github.com/orgs/firefly-iii/discussions/8694 and the answer you suggested is following the docs and downloading .zip file, that's why I got very confused. @JC5

[tasnim0tantawi]

I will try running it now