{"id":28072183,"url":"https://github.com/sulkhans/telex","last_synced_at":"2026-04-10T13:31:11.940Z","repository":{"id":292837060,"uuid":"982015559","full_name":"Sulkhans/Telex","owner":"Sulkhans","description":"Full-stack chat app","archived":false,"fork":false,"pushed_at":"2025-05-12T12:03:04.000Z","size":949,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T21:08:46.447Z","etag":null,"topics":["chat-application","express","neondb","postgresql","prisma","react","reactquery","socket-io","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://telex-jv2u.onrender.com","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/Sulkhans.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,"zenodo":null}},"created_at":"2025-05-12T08:48:37.000Z","updated_at":"2025-05-12T12:11:11.000Z","dependencies_parsed_at":"2025-05-12T12:45:16.850Z","dependency_job_id":null,"html_url":"https://github.com/Sulkhans/Telex","commit_stats":null,"previous_names":["sulkhans/telex"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sulkhans%2FTelex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sulkhans%2FTelex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sulkhans%2FTelex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sulkhans%2FTelex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sulkhans","download_url":"https://codeload.github.com/Sulkhans/Telex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253823442,"owners_count":21969847,"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":["chat-application","express","neondb","postgresql","prisma","react","reactquery","socket-io","tailwindcss","typescript"],"created_at":"2025-05-12T21:08:54.625Z","updated_at":"2025-12-30T20:20:55.091Z","avatar_url":"https://github.com/Sulkhans.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TELEX\n\nTelex is a full-stack real-time chat application built with React.\n\n![Preview](./previews/1.png)\n![Preview](./previews/2.png)\n\n## Features\n\n- **Authentication System**\n  Secure user registration with email confirmation\n- **User Status Management**\n  Customize your online presence\n- **Social Interactions**\n  Add friends by username\n  Direct messaging\n- **Message Management**\n  Edit and delete sent messages\n- **Channel Creation**\n  Create channels with shareable join links\n  Admin roles with message deletion and user management privileges\n\n## Tech Stack\n\n#### Backend\n\n- **Language \u0026 Framework**: Node.js with Express\n- **Database**: PostgreSQL\n- **ORM**: Prisma\n- **Key Dependencies**:\n  - `@prisma/client`\n  - `bcryptjs`\n  - `crypto`\n  - `express`\n  - `jsonwebtoken`\n  - `nodemailer`\n  - `socket.io`\n\n#### Frontend\n\n- **Framework**: React + Vite\n- **Language**: TypeScript\n- **Styling**: Tailwind CSS v4\n- **State Management**:\n  - React Query\n  - React Context\n- **HTTP Client**: Axios\n- **Key Dependencies**:\n  - `react`\n  - `react-router-dom`\n  - `@tanstack/react-query`\n  - `socket.io-client`\n\n## Installation Guide\n\n### Prerequisites\n\n1. **Email Configuration**\n\n   - Create a Google Account\n   - Generate an App Password:\n     - Go to Google Account \u003e Security\n     - Enable 2-Step Verification\n     - Go to App Passwords\n     - Select \"Mail\" and your device\n     - Copy the generated 16-character password\n\n2. **Database Setup**\n   - Option 1: Local PostgreSQL database\n   - Option 2: Create a free Neon.tech PostgreSQL database\n\n### Installation Steps\n\n##### 1. Clone the repository\n\n```bash\ngit clone https://github.com/Sulkhans/Telex.git\ncd Telex\n```\n\n##### 2. Install Backend Dependencies\n\n```bash\nnpm install\n```\n\n##### 3. Create `.env` File\n\n```\nPORT=5000\nNODE_ENV=development\nJWT_SECRET={your_jwt_secret}\nCORS_ORIGIN={http://localhost:5173}\nDATABASE_URL={your_database_connection_string}\nEMAIL_USER={your_google_email@gmail.com}\nEMAIL_PASS={your_generated_app_password}\n```\n\n##### 4. Install Frontend Dependencies\n\n```bash\ncd frontend\nnpm install\n```\n\n##### 5. Run the Application\n\n```bash\n# From project root\nnpm run backend  # Starts backend server\nnpm run frontend # Starts frontend development server\n```\n\n##### 6. Access the Application\n\nThe application will be available at `http://localhost:5173`\n\n### Notes\n\n- Confirmation emails might be filtered to the spam folder\n- Ensure all environment variables are correctly configured\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsulkhans%2Ftelex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsulkhans%2Ftelex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsulkhans%2Ftelex/lists"}