{"id":19752387,"url":"https://github.com/subhra264/hemontika","last_synced_at":"2026-05-11T13:08:27.422Z","repository":{"id":118912462,"uuid":"395646128","full_name":"Subhra264/hemontika","owner":"Subhra264","description":null,"archived":false,"fork":false,"pushed_at":"2021-11-02T14:45:58.000Z","size":1973,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-02-28T08:44:19.916Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Subhra264.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-13T12:26:10.000Z","updated_at":"2021-11-02T14:46:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"775dc4fe-c877-4479-a3e5-8a71ad2c3394","html_url":"https://github.com/Subhra264/hemontika","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Subhra264/hemontika","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhra264%2Fhemontika","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhra264%2Fhemontika/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhra264%2Fhemontika/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhra264%2Fhemontika/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Subhra264","download_url":"https://codeload.github.com/Subhra264/hemontika/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhra264%2Fhemontika/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32896012,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T02:49:02.087Z","updated_at":"2026-05-11T13:08:27.404Z","avatar_url":"https://github.com/Subhra264.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hemontika-web\n\n## Goals of the project\nThis is the Web Application for hemontika. Hemontika is a website where author can write their own poems, stories, novels, plays, share paintings, recitations (and many more) in multiple languages. We are working to make the UI of this application similar to the printed books. So that readers while reading can feel as if they are reading on a printed book.\n\n# Run in a local machine\nTo install in a local machine, you have to first fork it. After that, clone it to your local machine using git.\n```bash\ngit clone https://github.com/\u003cyour-username\u003e/hemontika.git\n```\n\nNow there are two options to run the application on your local machine - with docker and without docker\n\n## With docker\nIt is the easiest and the recommended method to run the application. \n\n### Pre-Requistics - \n1. you need to have docker and docker-compose installed(installing docker desktop will install both tools)\n\n### Procedure - \nOpen your terminal and type `sudo docker-compose up`. That's it! You will see that the server has started running after some time. Now open your browser and go to `127.0.0.1:8000/` . You will see the backend server is running. The front end part can be seen at `127.0.0.1:3000`.\n\n## Without docker - \nThis procedure is little bit complex compared to the previous one and can produce `Works on my computer` type errors. So be ready to solve those.\nAs this is a django + React app, you have to install python dependencies as well as npm dependencies. So let's start - \n### creating a virtual enviornment\nYou have to create a virtual enviornment for your project so that the python dependencies do not create conflicts due to different versions of same package. To create a virtual enviornment run the following commands - \n```bash\ncd backend_server/\npython -m venv venv\n```\n**Note: The above command is for windows. In linux you have to write `python3` instead of python**\nThis will create a virtual enviornment named `venv`. While creating virtual enviornment, make sure you named it as `venv`. Git will automatically ignore it.\n### activate the virtual environment\nBefore running any other command, first activate the virtual environment. The command for activaing the `venv` is different across different OS. For windows, run `venv/Scripts/activate` on the terminal, `source venv/bin/activate` for the rest of others. \n### install python dependencies \nRun the following command to install all python package requirements - \n```bash\npip install -r requirements.txt\n```\n### install npm dependencies \nNow if everything is fine, change your current directory from `backend_server` to `frontend` - `cd ../frontend`. Now run `yarn`. It will install all the npm dependencies for the application.\n### Run the front end\nRun the `yarn start` command on the terminal and you will be able to see the front end part at `127.0.0.1:3000`.\n### Run the server\nNow if all are great, change your current working directory to `backend_server/src`. Run `python manage.py runserver` and wait till the server starts. Now go to `127.0.0.1:8000/`. You will see the application running locally!\n\n# Contribution\nContributions are welcome. Feel free to create issues as well as PRs to make this application better! Please maintain the template for issues and PRs while creating them. To know more, see our Code_of_Conduct.md. \n\n# Tests\nWe mainly prefer test driven development. So before adding any new code, try to write tests first. Then do changes until the tests pass. This makes our code less buggy.\nBefore commiting any changes make sure it passes all the tests.\n### Running python tests\nGo to `backend_server/src` on your terminal and run the command -\n```bash\npytest .\n```\nIf all tests are passing, then check if the written code is following our style convention or not. Run `cd ..` and use `python -m flake8 .` and `black --check .` to do this. If any warning or error occur then please solve those. `black .` will help you to automatically resolve some of these errors.\n### Running Js tests\nGo to `frontend` on your terminal and run `yarn test` or `npm test` to run the javaScript tests.\n**Note: Passing flake8 and black checks are necessary to pass the circleci python tests. So make sure all the above tests are passing before opening any PR**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubhra264%2Fhemontika","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubhra264%2Fhemontika","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubhra264%2Fhemontika/lists"}