{"id":26718575,"url":"https://github.com/pripoliveira50/employee-management","last_synced_at":"2026-05-08T05:09:17.108Z","repository":{"id":279453432,"uuid":"938355150","full_name":"pripoliveira50/employee-management","owner":"pripoliveira50","description":"📱 Employee Management is a mobile application developed using React Native and Expo, designed to efficiently manage employees by providing quick access, clear organization, and better control over team information.","archived":false,"fork":false,"pushed_at":"2025-03-26T14:45:48.000Z","size":1155,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T15:44:44.814Z","etag":null,"topics":["app-development","expo","jest","jest-test","mobile-app","mobile-application","mobile-application-development","react-hook-form","react-native","react-native-app","react-query","testing-library","testing-library-react","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pripoliveira50.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-02-24T20:29:42.000Z","updated_at":"2025-03-26T14:52:59.000Z","dependencies_parsed_at":"2025-02-25T17:28:09.831Z","dependency_job_id":"50d6b19c-18eb-4a03-aaea-4424b85aa673","html_url":"https://github.com/pripoliveira50/employee-management","commit_stats":null,"previous_names":["pripoliveira50/employee-management"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pripoliveira50/employee-management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pripoliveira50%2Femployee-management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pripoliveira50%2Femployee-management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pripoliveira50%2Femployee-management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pripoliveira50%2Femployee-management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pripoliveira50","download_url":"https://codeload.github.com/pripoliveira50/employee-management/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pripoliveira50%2Femployee-management/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262667296,"owners_count":23345529,"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":["app-development","expo","jest","jest-test","mobile-app","mobile-application","mobile-application-development","react-hook-form","react-native","react-native-app","react-query","testing-library","testing-library-react","typescript"],"created_at":"2025-03-27T17:35:14.160Z","updated_at":"2026-05-08T05:09:12.082Z","avatar_url":"https://github.com/pripoliveira50.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 👥 Employee Management\n\n## 📖 Project Overview\n\n**Employee Management** is a mobile application built with **React Native** and **Expo**, designed to streamline employee management within organizations. It provides an intuitive interface to efficiently view, search, and organize employee information.\n\n---\n\n## 🚀 Technologies Used\n\n- **React Native 76**\n- **Expo**\n- **TypeScript**\n- **Jest** (Unit Testing)\n- **Testing Library**\n- **TanStack Query (React Query)**\n- **React Hook Form**\n\n---\n\n## 📂 Folder Structure\n\n```bash\n.\n├── android/                 # Android project (Expo Managed)\n├── ios/                     # iOS project (Expo Managed)\n├── src/                     # Main source code\n│   ├── components/          # Reusable UI components\n│   ├── global/tokens/       # Global design tokens and styles\n│   ├── infra/               # Project infrastructure and integrations\n│   ├── screens/             # Application screens\n│   └── utils/               # Utility functions\n├── test/                    # Test configurations\n├── jest.config.ts           # Jest configuration\n├── tsconfig.json            # TypeScript configuration\n├── metro.config.js          # Metro bundler configuration\n├── package.json             # Project dependencies\n└── README.md                # Project documentation\n```\n\n---\n\n## 🛠 Project Decisions\n\n### 🏗 Folder Structure\n\nThe project’s folder structure emphasizes **modularity**, **reusability**, and clear separation of concerns:\n\n- **`components/`**: Contains reusable UI components.\n- **`global/tokens/`**: Stores global design tokens to ensure visual consistency.\n- **`infra/`**: Includes core infrastructure and integration settings.\n- **`screens/`**: Organizes application screens in a modular way.\n- **`utils/`**: Houses helper functions to prevent code duplication.\n\nThis modular structure enhances **scalability** and simplifies **maintenance**.\n\n### ⚙️ Technology Choices\n\nThe project leverages **React Native 76** and **Expo** for fast, cross-platform development, reducing complexity in native configurations.\n\n**Core technologies rationale:**\n\n- **Expo**: Simplifies setup, deployment, and testing on devices.\n- **TypeScript**: Enhances code safety and maintainability.\n- **Jest + Testing Library**: Provides reliable, user-centric unit testing.\n- **React Query**: Efficiently manages async states, caching, and data synchronization.\n- **React Hook Form**: Offers performant and flexible form handling.\n\n### ✅ Testing Setup\n\nTesting is central to ensuring app reliability and functionality. The combination of **Jest** and **Testing Library** is chosen for:\n\n- Seamless integration with React Native.\n- Realistic user interaction simulations.\n- Readable and maintainable test cases using `getByText` and `fireEvent`.\n\nThe `test/` directory is intentionally centralized to keep testing configurations organized.\n\n### 🔧 Tools and Configurations\n\nEssential configuration files included in the project:\n\n- **`jest.config.ts`**: Optimizes Jest for React Native and Expo.\n- **`metro.config.js`**: Enhances Metro bundler performance.\n- **`tsconfig.json`**: Defines TypeScript rules for type safety and consistency.\n\n---\n\n## 📋 Prerequisites\n\nEnsure the following are installed on your system:\n\n- [Node.js](https://nodejs.org/) (recommended: v18+)\n- [Expo CLI](https://docs.expo.dev/get-started/installation/):\n\n```sh\nnpm install -g expo-cli\n```\n\n- [Yarn](https://yarnpkg.com/) (optional, recommended)\n\n---\n\n## 🚦 Getting Started\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/pripoliveira50/employee-management.git\ncd employee-management\n```\n\n2. **Install dependencies:**\n\n```sh\nyarn install\n```\n\n3. **Start Expo:**\n\n```sh\nyarn start\n```\n\n4. **Run on Emulator or Device:**\n\n- **Android:**\n\n```sh\nyarn android\n```\n\n- **iOS (macOS only):**\n\n```sh\nyarn ios\n```\n\n---\n\n## ✅ Running Tests\n\nExecute unit tests using **Jest**:\n\n```sh\nyarn test\n```\n\n---\n\n## 🎨 Interface Preview\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"/.github/assets/app.gif\" width=\"320\" alt=\"App Preview\"/\u003e\n\u003c/p\u003e\n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\nMade with ❤️ by [Priscila Oliveira](https://github.com/pripoliveira50/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpripoliveira50%2Femployee-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpripoliveira50%2Femployee-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpripoliveira50%2Femployee-management/lists"}