readme + package.json

This commit is contained in:
2023-04-27 17:43:01 +02:00
parent 99ff1abc5d
commit 64452abf6c
4 changed files with 43 additions and 6 deletions

5
.gitignore vendored
View File

@@ -11,4 +11,7 @@
*.log
# ignore node_modules (can be rebuilt with npm i --> shrinks repo size)
node_modules
node_modules
# ignore dist folder (this repo only contains source code!)
/dist

View File

@@ -23,6 +23,10 @@ Visit our [website](https://myevent.janishutz.com)
- any CPU from the last 10 years
- Any operating system that can run node.js
# Download
You may download this project using the GitHub releases page or the direct links on the [myevent website](https://myevent.janishutz.com/download) as this only downloads the ready-to-distribute version, not the development version.
Alternatively, you may download the project directly from GitHub (by cloning it or downloading the code) but you'll have to compile and package the project [manually](https://myevent.janishutz.com/docs/contributing/packaging).
# Contributing
If you want to contribute to this project, please read more [here](https://myevent.janishutz.com/docs/contributing). Until the end of October 2023, no contributions can be accepted into master.
@@ -31,16 +35,22 @@ If you like this project and it helped you save money, please consider donating
# Repository structure
- [assets/](/assets/): contains the logo (as png and GIMP file), also iOS and Android marketing materials, just global assets (images / videos)
- [dist/](/dist/): contains all files needed to run the app, set up correctly so you can just copy the folder.
- [src/](/src/): contains all of the source code of the project:
-
-
- [src/apps](/src/apps/): contains the source code of the iOS and Android app.
- [src/server](/src/server/): contains the source code for the node.js application that runs on the server side.
- [src/webapp](/src/webapp/): contains the source code for the frontend, contains lots of vue files.
- [website/](/website/): contains all of the website files:
- [website/dist/](/website/dist/): contains all the ready to distribute website files
- [website/src/](/website/src/): contains all of the source files (markdown format) for the website. These files are converted into HTML by the build script.
- [package.js][/package.js]: collects all of the files of the project and copies them into the [dist/](/dist/) folder.
- [package.js](/package.js): collects all of the files of the project and copies them into the [dist/](/dist/) folder. It also minifies the files in the process to reduce package size.
- [.eslintrc.js](/.eslintrc.js): ESlint config, the linter used for the project
- [.gitignore](/.gitignore): ignored files, currently is node_modules.
- [.gitignore](/.gitignore): ignored files, currently is node_modules & log files.
You may notice some additional folders appearing after running
```
npm run package
```
This is to shrink the repository size. Distribution ready files can be found in the releases or on our [website](https://myevent.janishutz.com/download).
## This project is currently NOT ready to be used!
Development of this project is currently ongoing and no stable version is available yet.

24
package.json Normal file
View File

@@ -0,0 +1,24 @@
{
"name": "myevent",
"version": "1.0.0",
"description": "A free and open source event management solution",
"main": "/dist/app.js",
"scripts": {
"test": "npm run test"
},
"repository": {
"type": "git",
"url": "git+https://github.com/simplePCBuilding/myevent.git"
},
"keywords": [
"eventmanager",
"events",
"tickets"
],
"author": "Janis Hutz",
"license": "GPL-3.0-or-later",
"bugs": {
"url": "https://github.com/simplePCBuilding/myevent/issues"
},
"homepage": "https://myevent.janishutz.com"
}