{"id":16601592,"url":"https://github.com/amankumarsinhagithub/to-do-list-app","last_synced_at":"2025-10-29T13:31:53.027Z","repository":{"id":163942272,"uuid":"609101541","full_name":"AmanKumarSinhaGitHub/To-Do-List-App","owner":"AmanKumarSinhaGitHub","description":" Manage your tasks efficiently with the To-Do List App. This Node.js and MongoDB-powered application provides a seamless task management experience, helping you stay organized and focused. ","archived":false,"fork":false,"pushed_at":"2024-01-04T12:51:21.000Z","size":243,"stargazers_count":21,"open_issues_count":0,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-02T01:51:10.085Z","etag":null,"topics":["backend","css","ejs","express","html","javascript","mongodb","nodejs","project","todoapp","todolist"],"latest_commit_sha":null,"homepage":"https://to-do-list-rz0n.onrender.com/","language":"JavaScript","has_issues":true,"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/AmanKumarSinhaGitHub.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}},"created_at":"2023-03-03T11:31:40.000Z","updated_at":"2024-10-24T10:17:40.000Z","dependencies_parsed_at":"2023-07-20T07:00:54.662Z","dependency_job_id":"1c647cf8-3239-4ccb-8ee1-7eb8279063fa","html_url":"https://github.com/AmanKumarSinhaGitHub/To-Do-List-App","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmanKumarSinhaGitHub%2FTo-Do-List-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmanKumarSinhaGitHub%2FTo-Do-List-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmanKumarSinhaGitHub%2FTo-Do-List-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmanKumarSinhaGitHub%2FTo-Do-List-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AmanKumarSinhaGitHub","download_url":"https://codeload.github.com/AmanKumarSinhaGitHub/To-Do-List-App/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238832332,"owners_count":19538272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["backend","css","ejs","express","html","javascript","mongodb","nodejs","project","todoapp","todolist"],"created_at":"2024-10-12T00:18:37.024Z","updated_at":"2025-10-29T13:31:53.021Z","avatar_url":"https://github.com/AmanKumarSinhaGitHub.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# To-Do List App ⭐\n\nThe To-Do List App is a Node.js, Express, MongoDB, and EJS templating engine-based application designed to help users efficiently manage their tasks.\n\n### Click Here to Open [To-Do List App](https://to-do-list-rz0n.onrender.com/)\n\n![Todo App Preview](https://github.com/AmanKumarSinhaGitHub/To-Do-List-App/assets/65329366/3e810143-7dbd-46d5-a21d-1bea26a731dc)\n\n## Prerequisites\n\nBefore running this project, ensure you have the following installed:\n\n- Node.js: [Download and Install Node.js](https://nodejs.org/en/download)\n- MongoDB: [Download and Install MongoDB](https://www.mongodb.com/try/download/community)\n\n## Installation\n\nFollow these steps to set up the application:\n\n1. Clone the repository to your local machine:\n\n   ```bash\n   git clone https://github.com/AmanKumarSinhaGitHub/To-Do-List-App.git\n   ```\n\n2. Navigate to the project directory:\n\n   ```bash\n   cd To-Do-List-App\n   ```\n\n3. Install the required dependencies:\n\n   ```bash\n   npm install\n   ```\n\n4. Install additional packages:\n\n   ```bash\n   npm install mongoose lodash\n   ```\n\n## Get Started\n\nTo run the To-Do List App, perform the following actions:\n\n1. Open a new PowerShell window.\n\n2. Start MongoDB:\n\n   ```bash\n   mongod\n   ```\n\n3. Open another PowerShell window.\n\n4. Launch the MongoDB shell:\n\n   ```bash\n   mongosh\n   ```\n\n5. Navigate to the project directory:\n\n   ```bash\n   cd To-Do-List-App\n   ```\n\n6. Start the application using nodemon:\n\n   ```bash\n   nodemon .\\app.js\n   ```\n\n   **Note: If you encounter a \"nodemon not recognized\" error, install nodemon globally:**\n\n   ```bash\n   npm install -g nodemon\n   ```\n\n7. Open a web browser and navigate to [localhost:3000](http://localhost:3000) to access the application.\n\n### Important: ⚠️\n\n**Set up backend connection locally:**\n\n- If running this project locally, uncomment the following code in `app.js`:\n\n   ```js\n   mongoose.connect(\"mongodb://127.0.0.1:27017/todolistDB\");\n   ```\n\n   And comment out the below code in ```app.js```:\n\n   ```js\n   // const DB = process.env.DATABASE;\n   // mongoose.connect(DB)\n   ```\n\n## Usage\n\n- **Home Page (http://localhost:3000):** Default page showing the \"Today\" list. Add new items by typing in the input field and clicking the \"+\" button.\n\n- **Custom Lists:** Create custom lists by adding a name in the URL (e.g., http://localhost:3000/work). Add items and access the list using the specified name.\n\n- **Deleting Items:** Click the checkbox next to an item to mark it as completed and automatically remove it from the list.\n\n- **About Page (http://localhost:3000/about):** Information about the To-Do List application.\n\n## Project Structure\n\n- `app.js:` Main entry point of the application. Configures the server, sets up routes, and connects to the database.\n\n   **Models:**\n\n   - `Item:` Model for individual to-do list items.\n   - `List:` Model for custom lists.\n\n- `public:` Directory containing static files such as CSS stylesheets.\n   - `styles.css:` CSS stylesheets for the application.\n\n- `views:` Directory containing EJS templates used to render HTML pages.\n\n   - `header.ejs:` Header template included in other EJS files.\n   - `footer.ejs:` Footer template included in other EJS files.\n   - `list.ejs:` Template for the to-do list page.\n   - `about.ejs:` Template for the about page.\n\n## Contributing\n\nContributions are welcome! Please follow the steps below to contribute to the project:\n\n1. Fork the repository.\n\n2. Create a new branch for your feature or bug fix:\n\n   ```bash\n   git checkout -b feature/your-feature-name\n   ```\n\n3. Make your changes and commit them:\n\n   ```bash\n   git add .\n   git commit -m \"Add your meaningful commit message\"\n   ```\n\n4. Push your changes to your forked repository:\n\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n5. Open a pull request on the original repository.\n\n### Code Style Guidelines\n\n- Follow the existing code style and structure.\n\n- Write meaningful commit messages.\n\n### Bug Reporting\n\nIf you encounter any bugs or issues, please open an issue with a detailed description of the problem, steps to reproduce, and your system/environment information.\n\n## Acknowledgments\n\nThis project was created using Node.js, Express, MongoDB, and the EJS templating engine. Special thanks to the authors and contributors of these technologies.\n\n## 🚀 About Me\n\nI'm a final-year BCA undergraduate and a full-stack developer.\n\n### Contact Details\n\n- Email: amankrsinha07@gmail.com\n- LinkedIn Profile: [@AmanKumarSinha](https://www.linkedin.com/in/amankumarsinha)\n\n## Checkout my new TO DO LIST app in REACT\n- GitHub link - https://github.com/AmanKumarSinhaGitHub/React-To-Do-List-App\n- LIVE demo - https://amankumarsinhagithub.github.io/React-To-Do-List-App/\n- Addition feature of this app : Your to-do list is automatically saved to local storage. This means your tasks will stay even if you refresh the page or reopen the app.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famankumarsinhagithub%2Fto-do-list-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famankumarsinhagithub%2Fto-do-list-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famankumarsinhagithub%2Fto-do-list-app/lists"}