{"id":24651812,"url":"https://github.com/rastereo/webletter-front","last_synced_at":"2026-05-16T20:34:02.716Z","repository":{"id":272622009,"uuid":"872318401","full_name":"rastereo/webletter-front","owner":"rastereo","description":"A web application for browsing a catalog of ready-made HTML emails.","archived":false,"fork":false,"pushed_at":"2025-03-18T15:27:05.000Z","size":282,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T16:37:44.822Z","etag":null,"topics":["dark-mode","email","fsd","html","html-emails","letters","react","typescript","vite"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/rastereo.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":"2024-10-14T08:27:04.000Z","updated_at":"2025-03-18T15:27:09.000Z","dependencies_parsed_at":"2025-01-15T17:33:45.646Z","dependency_job_id":"77e02871-3326-458d-8698-a7b3c86a4837","html_url":"https://github.com/rastereo/webletter-front","commit_stats":null,"previous_names":["rastereo/webletter-front"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rastereo/webletter-front","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rastereo%2Fwebletter-front","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rastereo%2Fwebletter-front/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rastereo%2Fwebletter-front/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rastereo%2Fwebletter-front/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rastereo","download_url":"https://codeload.github.com/rastereo/webletter-front/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rastereo%2Fwebletter-front/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33117875,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T18:38:32.183Z","status":"ssl_error","status_checked_at":"2026-05-16T18:38:29.903Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["dark-mode","email","fsd","html","html-emails","letters","react","typescript","vite"],"created_at":"2025-01-25T19:13:08.709Z","updated_at":"2026-05-16T20:34:02.699Z","avatar_url":"https://github.com/rastereo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Webletter Frontend\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://i.ibb.co/MBttJz8/1.png\" alt=\"Image 1\" width=\"400\" border=\"0\" /\u003e\n  \u003cimg src=\"https://i.ibb.co/KDVGPtt/2.png\" alt=\"Image 2\" width=\"400\" border=\"0\" /\u003e\n\u003c/div\u003e\n\nWebLetter is a web application for browsing a catalog of ready-made HTML emails. It provides a user-friendly interface for searching emails by sender name, subject, language, and date, as well as viewing each email in detail. This makes it especially useful for marketers and other professionals involved in email campaigns.\n\n## 🔧Installation\n\nTo get started with the project, ensure that you have [Node.js](https://nodejs.org/en) installed. Then, clone this repository and install the dependencies:\n\n```bash\ngit clone https://github.com/rastereo/webletter-front.git\ncd webletter-front\nnpm install\n```\n\n## 🌍Environment Variables\n\nThe project utilizes several environment variables for configuration. These should be defined in a `.env` file at the root of your project. Below is a description of each variable:\n\n- `VITE_APP_SERVER_BASE_URL`: The base URL for the main server.\n- `VITE_APP_DEV_SERVER_BASE_URL`: Base URL for the development server.\n- `VITE_APP_HTML_WEBLETTER_URL`: The base URL for web letter resources.\n- `VITE_APP_LOGIN_PATH`: The path for logging into the application.\n- `VITE_APP_LOGOUT_PATH`: The path for logging out of the application.\n- `VITE_APP_VERIFY_PATH`: The path for token verification.\n- `VITE_APP_WEBLETTERS_PATH`: The path to access web letter data.\n- `VITE_APP_SEARCH_WEBLETTERS_PATH`: The path for searching web letters.\n- `VITE_APP_WEBLETTER_TEXT_PATH`: The path for accessing the text content of web letters.\n- `VITE_APP_JWT_COOKIE_NAME`: The name of the cookie used to store JWT tokens.\n- `VITE_APP_CREDENTIALS`: Credentials configuration, typically used to manage if credentials like cookies are sent with requests.\n\nEnsure that these variables are properly configured in your environment to enable the application to function as expected.\n\n## ⚙️Scripts\n\nThe project defines several npm scripts to streamline development workflows.\n\n- Builds the application using TypeScript and Vite.\n\n```bash\nnpm run build\n```\n\n- Starts a development server using Vite.\n\n```bash\nnpm run dev\n```\n\n## 🔀Routing\n\n- `/:` Displays the search page for querying web letters.\n- `/:id` Viewer for displaying a specific web letter based on its ID.\n- `/login` A login page for user authentication.\n\nThe ProtectedRoute component ensures that only authenticated users can access certain routes.\n\n## 🤖 Technologies\n\nThe project leverages the following technologies:\n\n- [Vite](https://vite.dev/)\n- [React](https://react.dev/)\n- [Redux Toolkit](https://redux-toolkit.js.org/)\n- [TypeScript](https://www.typescriptlang.org/)\n- [Chakra UI](https://www.chakra-ui.com/)\n- [Dark Reader](https://www.npmjs.com/package/darkreader)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frastereo%2Fwebletter-front","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frastereo%2Fwebletter-front","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frastereo%2Fwebletter-front/lists"}