{"id":27213473,"url":"https://github.com/maina-m19/user_search_app","last_synced_at":"2026-04-18T04:33:05.954Z","repository":{"id":287059808,"uuid":"963437696","full_name":"Maina-M19/User_Search_App","owner":"Maina-M19","description":"Full-stack user search app using React (frontend) and Flask (backend) that supports free text search by first name, last name, and SSN. Built as a coding assignment.","archived":false,"fork":false,"pushed_at":"2025-04-09T18:37:17.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T19:31:13.007Z","etag":null,"topics":["flask","python3","react"],"latest_commit_sha":null,"homepage":"","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/Maina-M19.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":"2025-04-09T17:21:44.000Z","updated_at":"2025-04-09T18:37:20.000Z","dependencies_parsed_at":"2025-04-09T19:31:30.993Z","dependency_job_id":"3db96206-5f22-4a11-bec7-a5f47b726989","html_url":"https://github.com/Maina-M19/User_Search_App","commit_stats":null,"previous_names":["maina-m19/user_search_app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maina-M19%2FUser_Search_App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maina-M19%2FUser_Search_App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maina-M19%2FUser_Search_App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maina-M19%2FUser_Search_App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maina-M19","download_url":"https://codeload.github.com/Maina-M19/User_Search_App/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248144965,"owners_count":21055018,"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":["flask","python3","react"],"created_at":"2025-04-10T02:41:56.157Z","updated_at":"2026-04-18T04:33:05.947Z","avatar_url":"https://github.com/Maina-M19.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# User Search App\n\nA full-stack web application that allows users to perform free-text searches by first name, last name, or SSN. Built as a coding assignment, this project utilizes React for the frontend and Flask for the backend.\n\n---\n\n## Features\n\n- **Search Functionality**: Perform free-text searches by first name, last name, or SSN.\n- **Responsive Design**: Ensures usability across various devices and screen sizes.\n- **RESTful API**: Backend API built with Flask to handle search queries.\n\n---\n\n## Technologies Used\n\n- **Frontend**:\n  - React\n  - JavaScript\n  - HTML/CSS\n\n- **Backend**:\n  - Flask\n  - Python 3\n  - SQLite\n\n---\n\n## Project Structure\n\n```\nUser_Search_App/\n├── backend/\n│   ├── app.py\n│   └── ... (other backend files)\n├── frontend_react/\n│   ├── public/\n│   └── src/\n│       ├── components/\n│       ├── App.js\n│       └── index.js\n├── README.md\n└── requirements.txt\n```\n\n---\n\n## Setup Instructions\n\n### Prerequisites\n\n- Node.js and npm installed\n- Python 3 installed\n- Git installed\n\n### Backend Setup\n\n1. Navigate to the backend directory:\n   ```bash\n   cd backend\n   ```\n\n2. Create a virtual environment:\n   ```bash\n   python -m venv venv\n   ```\n\n3. Activate the virtual environment:\n   - On macOS/Linux:\n     ```bash\n     source venv/bin/activate\n     ```\n   - On Windows:\n     ```bash\n     venv\\Scripts\\activate\n     ```\n\n4. Install the required packages:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n5. Run the Flask application:\n   ```bash\n   python app.py\n   ```\n   The backend server will start on `http://localhost:5000`.\n\n### Frontend Setup\n\n1. Navigate to the frontend directory:\n   ```bash\n   cd frontend_react\n   ```\n\n2. Install the required packages:\n   ```bash\n   npm install\n   ```\n\n3. Start the React application:\n   ```bash\n   npm start\n   ```\n   The frontend will be accessible at `http://localhost:3000`.\n\n---\n\n## Usage\n\n1. **Access the application**:\n   Open your browser and navigate to `http://localhost:3000`.\n\n2. **Perform a search**:\n   - Enter a first name, last name, or SSN into the search bar.\n   - Click the \"Search\" button to view matching results.\n\n---\n\n## API Endpoints\n\n- `GET /api/search?query=\u003csearch_term\u003e`: Retrieve users matching the search term.\n\n---\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch:\n   ```bash\n   git checkout -b feature/YourFeature\n   ```\n3. Commit your changes:\n   ```bash\n   git commit -m 'Add some feature'\n   ```\n4. Push to the branch:\n   ```bash\n   git push origin feature/YourFeature\n   ```\n5. Open a pull request.\n\n---\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaina-m19%2Fuser_search_app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaina-m19%2Fuser_search_app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaina-m19%2Fuser_search_app/lists"}