Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/theovidal/105app

πŸ“‘ Website to store my school revisions
https://github.com/theovidal/105app

pwa revisions studies vuejs

Last synced: about 2 months ago
JSON representation

πŸ“‘ Website to store my school revisions

Awesome Lists containing this project

README

        


105 logo

Revise the best way


Website






License


Opened issues

- [🌈 How it works](#-how-it-works)
- [πŸ“¬ Adding files](#-adding-files)
- [πŸ’» Development](#-development)
- [Environment setup](#environment-setup)
- [Building the app](#building-the-app)
- [Linting and fixing files](#linting-and-fixing-files)
- [Customizing configuration](#customizing-configuration)
- [πŸ“œ Credits](#-credits)
- [πŸ” License](#-license)

## 🌈 How it works

This simple app stores files in defined formats for example Microsoft Word and PDF, and then displays PDFs or JSON lists to the user. These files are organized by subjects, the user can search files and store them in personal, client-side libraries.

French students personally wrote these files that aim to help others during exam revisions.

## πŸ“¬ Adding files

If you want to add your own file to 105, head over to [the adding form](https://framaforms.org/soumettre-une-fiche-pour-105app-1593639677) and complete it!

## πŸ’» Development

Make sure you have NodeJS 12+ installed on your computer, as well as Git in any form - CLI, UI, GitHub...

### Environment setup

First of all, clone the repository from GitHub on your local machine : (this requires Git to be installed)

```bash
git clone https://github.com/theovidal/105app.git # Using HTTP
git clone [email protected]:theovidal/105app # Using SSH
```

Install the required dependencies using your favorite package manager :

```bash
npm install # Using NPM
yarn install # Using Yarn
```

Then, run the application using the `serve` command : (Make sure you installed Vue CLI on your system)

```bash
npm run serve # Using NPM
yarn serve # Using Yarn
```

A web server will start with hot reload enabled, perfect to develop.

### Building the app

To get a built version of the application ready to be served by a HTTP server, use the `build` command :

```bash
npm run build # Using NPM
yarn build # Using Yarn
```

Files will be generated in the `dist` folder, and the entry point will be the `index.html` file.

### Linting and fixing files

To lint the files and check for formatting, run the `lint` command :

```bash
npm run lint # Using NPM
yarn lint # Using Yarn
```

If a better formatting is available, new code will be written directly inside the concerned files.

### Customizing configuration

If you want to customize the build configuration, check the [Configuration Reference](https://cli.vuejs.org/config/) on the Vue CLI documentation.

## πŸ“œ Credits

- Main libraries : [VueJS](https://vuejs.org), [Vuetify](https://vuetifyjs.com)
- Maintainer : [ThΓ©o Vidal](https://github.com/theovidal)

## πŸ” License

This project is under the [GNU GPL v3](./LICENSE) license.