Skip to content

Update README with new instructions. #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 20, 2025
Merged

Update README with new instructions. #12

merged 2 commits into from
Apr 20, 2025

Conversation

SohamG
Copy link

@SohamG SohamG commented Feb 16, 2025

No description provided.

README.md Outdated
Comment on lines 23 to 44
## Installation
This will produce a symlink called "result" in your local directory. The program
can be run as follows:

These steps seem to require python2, which does not ship with most linux distributions and is sunset. Therefore, it is recommended to run this app through docker instead (though of course, vulnerability will still exist - they will just be constrained to the container).
1. Clone the repository.
2. Navigate to the repository directory.
3. Create a `.env` file based on `.env.example`.
4. Run `npm install` to install dependencies.

## How to use

1. Run `npm run start` to start the npm server or `npm run watch` to watch for changes.
2. Navigate the browser to `locahost:8080` or the port specified in the `.env` config.

## Offline Mode

Offline mode will disable api requests to the server leaving only the clock running. It can be activated by going to `/offline` path.

## Demo Mode
Demo mode works like offline mode but displays demo information instead of real data from apis. It can be activated by going to `/demo` path.

## Configuration
To override the default config, you can use the URL GET parameters or by pressing `c` to open the config options.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like these details about the application itself is still kinda useful to know about. Can we keep this and perhaps rename this section. It's not really installation details. It's more like application usage details or something like that?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm okay. Though it no longer needs python2

@SohamG
Copy link
Author

SohamG commented Apr 20, 2025

@clee231 Please can you take a look again

Copy link

@clee231 clee231 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 😆

@SohamG SohamG merged commit fe42993 into main Apr 20, 2025
3 checks passed
@SohamG SohamG deleted the new-readme branch April 20, 2025 17:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants