{"id":29112685,"url":"https://github.com/nobiscumdeus/attenapse","last_synced_at":"2026-04-29T21:03:23.101Z","repository":{"id":301173345,"uuid":"1008384356","full_name":"Nobiscumdeus/Attenapse","owner":"Nobiscumdeus","description":"Attenapse is an intelligent attendance tracking system designed for modern groups, institutions, and events. It enables effortless check-ins, real-time presence logging, and detailed attendance analytics—all within an intuitive platform.","archived":false,"fork":false,"pushed_at":"2025-06-25T14:32:55.000Z","size":3637,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T14:41:32.628Z","etag":null,"topics":["attendance-management-system","fastapi","reactjs","storybook"],"latest_commit_sha":null,"homepage":"https://nobiscumdeus.github.io/Attenapse/","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/Nobiscumdeus.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-06-25T13:11:02.000Z","updated_at":"2025-06-25T14:37:38.000Z","dependencies_parsed_at":"2025-06-25T14:53:03.504Z","dependency_job_id":null,"html_url":"https://github.com/Nobiscumdeus/Attenapse","commit_stats":null,"previous_names":["nobiscumdeus/attenapse"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Nobiscumdeus/Attenapse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nobiscumdeus%2FAttenapse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nobiscumdeus%2FAttenapse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nobiscumdeus%2FAttenapse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nobiscumdeus%2FAttenapse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nobiscumdeus","download_url":"https://codeload.github.com/Nobiscumdeus/Attenapse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nobiscumdeus%2FAttenapse/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32443576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T20:22:27.477Z","status":"ssl_error","status_checked_at":"2026-04-29T20:22:26.507Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["attendance-management-system","fastapi","reactjs","storybook"],"created_at":"2025-06-29T11:02:06.354Z","updated_at":"2026-04-29T21:03:23.085Z","avatar_url":"https://github.com/Nobiscumdeus.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎯 Attenapse\r\n\r\nA modern full-stack application for attention-based analytics and user engagement tracking, built with React and FastAPI.\r\n\r\n## 🌟 Live Demos\r\n\r\n| Service | URL | Description |\r\n|---------|-----|-------------|\r\n\r\n| 📚 **API Docs** | [https://nobiscumdeus.github.io/Attenapse/](https://nobiscumdeus.github.io/Attenapse/) | Interactive API documentation |\r\n| 🎨 **Storybook** | [https://nobiscumdeus.github.io/Attenapse/storybook](https://nobiscumdeus.github.io/Attenapse/storybook) | Component library \u0026 design system |\r\n\r\n## 🛠 Tech Stack\r\n\r\n**Frontend**\r\n- React 16 ++\r\n- Tailwind CSS for styling  \r\n- Storybook for component documentation\r\n- Responsive design principles\r\n\r\n**Backend**\r\n- FastAPI with Python 3.11+\r\n- Pydantic for data validation\r\n- Auto-generated API documentation\r\n- RESTful API architecture\r\n\r\n**Deployment**\r\n- GitHub Pages (Storybook)\r\n\r\n## ✨ Key Features\r\n\r\n- 📊 Real-time attention analytics\r\n- 📱 Fully responsive interface\r\n- 🎯 Interactive data visualizations\r\n- 📝 Auto-generated API documentation\r\n- 🎨 Comprehensive component library\r\n\r\n## 🚀 Quick Start\r\n\r\n### Prerequisites\r\n- Node.js 18+\r\n- Python 3.11+\r\n- Git\r\n\r\n### Local Development\r\n\r\n**1. Clone the repository**\r\n```bash\r\ngit clone https://github.com/yourusername/Attenapse.git\r\ncd Attenapse\r\n```\r\n\r\n**2. Start the backend**\r\n```bash\r\ncd backend\r\npip install -r requirements.txt\r\nuvicorn app:app --host 0.0.0.0 --port 8000 --reload\r\n```\r\nBackend runs on: http://localhost:8000\r\n\r\n**3. Start the frontend**\r\n```bash\r\ncd frontend\r\nnpm install\r\nnpm start\r\n```\r\nFrontend runs on: http://localhost:5173  or http://localhost:3000\r\n\r\n**4. Run Storybook (Optional)**\r\n```bash\r\ncd frontend\r\nnpm run storybook\r\n```\r\nStorybook runs on: http://localhost:6006\r\n\r\n## 📚 API Documentation\r\n\r\nFastAPI automatically generates comprehensive API documentation:\r\n\r\n- **Swagger UI**: `http:localhost:8000/docs` - Interactive API testing interface\r\n- **ReDoc**: `http:localhost:8000/redoc` - Clean, readable documentation format\r\n\r\n### Key API Endpoints\r\n- Follows REST API\r\n\r\n## 🎨 Component Library\r\n\r\nExplore our design system and component library in Storybook:\r\n\r\n- **Component Documentation** - Props, variants, and usage examples\r\n- **Design Tokens** - Colors, typography, spacing system\r\n- **Interactive Demos** - Live component playground\r\n- **Accessibility Guidelines** - WCAG compliance examples\r\n\r\nPerfect for developers and designers to understand the interface patterns.\r\n\r\n## 🏗 Project Structure\r\n\r\n```\r\nAttenapse/\r\n├── frontend/                 # React TypeScript application\r\n│   ├── src/\r\n│   │   ├── components/      # Reusable UI components\r\n│   │   ├── pages/          # Application pages\r\n│   │   ├── hooks/          # Custom React hooks\r\n│   │   └── stories/        # Storybook component stories\r\n│   ├── .storybook/         # Storybook configuration\r\n│   └── package.json\r\n├── backend/                 # FastAPI Python application\r\n│   ├── app.py\r\n│   │         # Business logic\r\n│   ├── /alembic         # FastAPI application entry\r\n│   └── requirements.txt\r\n├── docs/                   # GitHub Pages documentation\r\n└── README.md\r\n```\r\n\r\n## 🚀 Deployment\r\n\r\nThis project uses automated deployment pipelines:\r\n\r\n- **Frontend**: Auto-deploys to Netlify from `main` branch\r\n- **Backend**: Auto-deploys to Railway from `main` branch  \r\n- **Storybook**: Deployed to GitHub Pages via Actions\r\n\r\n### Manual Deployment\r\n\r\n**Frontend**\r\n```bash\r\ncd frontend\r\nnpm run build\r\n# Deploy build/ folder to your hosting service\r\n```\r\n\r\n**Backend**\r\n```bash\r\n# Ensure requirements.txt is updated\r\npip freeze \u003e requirements.txt\r\ngit push origin main  # Triggers auto-deployment\r\n```\r\n\r\n## 🧪 Testing\r\n\r\n```bash\r\n# Frontend tests\r\ncd frontend\r\nnpm test\r\n\r\n# Backend tests  \r\ncd backend\r\npython -m pytest\r\n```\r\n\r\n## 📄 License\r\n\r\nMIT License \r\n\r\n## 👨‍💻 Connect\r\n\r\nBuilt with ❤️ by [Olumide E. Adeola ]\r\n\r\n- 🌐 **Portfolio**: [https://chasfatprojects.netlify.app](https:chasfatprojects.netlify.app)\r\n- 🐙 **GitHub**: [@nobiscumdeus](https://github.com/nobiscumdeus.git)\r\n\r\n---\r\n\r\n⭐ **Star this repository if you find it useful!**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnobiscumdeus%2Fattenapse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnobiscumdeus%2Fattenapse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnobiscumdeus%2Fattenapse/lists"}