{"id":30429579,"url":"https://github.com/shanefully-done/miscalc","last_synced_at":"2026-04-29T19:05:38.708Z","repository":{"id":228505214,"uuid":"522555316","full_name":"shanefully-done/miscalc","owner":"shanefully-done","description":"miscalc is a modern web application that helps you determine the missing calorie, carb, protein, or fat content in a food label.","archived":false,"fork":false,"pushed_at":"2025-08-07T08:09:41.000Z","size":210,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-13T01:22:17.390Z","etag":null,"topics":["calculator","nutrient"],"latest_commit_sha":null,"homepage":"https://miscalc.ixtj.dev","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/shanefully-done.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-08-08T13:13:09.000Z","updated_at":"2025-08-07T08:09:44.000Z","dependencies_parsed_at":"2024-03-19T05:41:25.579Z","dependency_job_id":"27ebd496-84f7-466c-853b-45e5e422e613","html_url":"https://github.com/shanefully-done/miscalc","commit_stats":null,"previous_names":["shanefully-done/missing-nutrient-calculator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shanefully-done/miscalc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanefully-done%2Fmiscalc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanefully-done%2Fmiscalc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanefully-done%2Fmiscalc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanefully-done%2Fmiscalc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shanefully-done","download_url":"https://codeload.github.com/shanefully-done/miscalc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanefully-done%2Fmiscalc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32439366,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T18:12:22.909Z","status":"ssl_error","status_checked_at":"2026-04-29T18:11:33.322Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["calculator","nutrient"],"created_at":"2025-08-22T17:33:09.796Z","updated_at":"2026-04-29T19:05:38.689Z","avatar_url":"https://github.com/shanefully-done.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# miscalc\n\nA modern web application for calculating missing macronutrient values using Next.js 15 and shadcn/ui components. miscalc helps users determine the missing nutrient (calories, carbohydrates, protein, or fat) when three of the four values are provided.\n\n## Features\n\n- **Smart Calculation**: Automatically calculates the missing macronutrient using standard nutritional conversion rates\n- **Interactive UI**: Auto-disables the 4th input when 3 values are provided\n- **Bilingual Support**: Full English and Korean language support\n- **Responsive Design**: Optimized for mobile, tablet, and desktop\n- **Real-time Results**: Instant calculation and display of missing nutrients\n- **Reset Functionality**: One-click reset to start fresh calculations\n\n## How It Works\n\nmiscalc uses standard nutritional science to calculate missing values:\n\n- **Carbohydrates**: 4 calories per gram\n- **Protein**: 4 calories per gram\n- **Fat**: 9 calories per gram\n- **Total Calories** = (Carbs × 4) + (Protein × 4) + (Fat × 9)\n\n### Calculation Examples\n\n- **Missing Calories**: `(carbs × 4) + (protein × 4) + (fat × 9)`\n- **Missing Carbs**: `(calories - (protein × 4) - (fat × 9)) / 4`\n- **Missing Protein**: `(calories - (carbs × 4) - (fat × 9)) / 4`\n- **Missing Fat**: `(calories - (carbs × 4) - (protein × 4)) / 9`\n\n## Tech Stack\n\n- **Framework**: Next.js 15 (App Router)\n- **Runtime**: Bun\n- **UI Library**: shadcn/ui components\n- **Styling**: Tailwind CSS\n- **Language**: TypeScript\n- **Deployment**: Vercel\n\n## Getting Started\n\n### Prerequisites\n\n- [Bun](https://bun.sh/) installed on your system\n- Node.js 18+ (for compatibility)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone [repository-url]\ncd miscalc\n\n# Install dependencies\nbun install\n\n# Run the development server\nbun run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) in your browser to see the application.\n\n### Build for Production\n\n```bash\n# Build the application\nbun run build\n\n# Start the production server\nbun start\n```\n\n## Usage\n\n1. **Enter Values**: Fill in any 3 of the 4 nutrient fields (calories, carbs, protein, fat)\n2. **View Result**: The missing nutrient will be calculated and displayed automatically\n3. **Reset**: Click the reset button to clear all values and start over\n4. **Language**: Switch between English and Korean using the language toggle\n\n## Development\n\n### Project Structure\n\n```\nmiscalc/\n├── app/                    # Next.js app directory\n├── components/            # React components\n├── hooks/                 # Custom React hooks\n├── lib/                   # Utility functions\n├── types/                 # TypeScript type definitions\n└── public/               # Static assets\n```\n\n### Key Components\n\n- **NutrientCalculator**: Main calculator component\n- **NutrientInput**: Individual input fields with validation\n- **LanguageSwitcher**: Bilingual support toggle\n- **ResetButton**: Clear all inputs functionality\n\n### Available Scripts\n\n- `bun run dev` - Start development server\n- `bun run build` - Build for production\n- `bun start` - Start production server\n- `bun run lint` - Run ESLint\n- `bun run type-check` - Run TypeScript type checking\n\n## Performance\n\n- **First Contentful Paint**: \u003c 1.5s\n- **Time to Interactive**: \u003c 2.0s\n- **Lighthouse Score**: \u003e 95 across all metrics\n- **Bundle Size**: \u003c 100KB gzipped\n\n## Accessibility\n\n- WCAG 2.1 AA compliant\n- Full keyboard navigation support\n- Screen reader compatible\n- High contrast ratios\n- Focus management\n\n## License\n\nMIT License - see LICENSE file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshanefully-done%2Fmiscalc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshanefully-done%2Fmiscalc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshanefully-done%2Fmiscalc/lists"}