{"id":20983222,"url":"https://github.com/spacenectar/box-tracker","last_synced_at":"2026-04-27T19:05:05.918Z","repository":{"id":41786964,"uuid":"108311135","full_name":"spacenectar/box-tracker","owner":"spacenectar","description":"An app to help you keep track of boxes during a move","archived":false,"fork":false,"pushed_at":"2025-12-12T00:24:44.000Z","size":7222,"stargazers_count":0,"open_issues_count":17,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-26T08:36:37.465Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/spacenectar.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"foxleigh81","patreon":"spacenectar","open_collective":null,"ko_fi":"foxleigh81","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2017-10-25T18:43:03.000Z","updated_at":"2025-03-18T20:13:31.000Z","dependencies_parsed_at":"2025-03-02T18:28:12.196Z","dependency_job_id":"297b0d5a-31a4-42ae-af46-f20a75e4809b","html_url":"https://github.com/spacenectar/box-tracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/spacenectar/box-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenectar%2Fbox-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenectar%2Fbox-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenectar%2Fbox-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenectar%2Fbox-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spacenectar","download_url":"https://codeload.github.com/spacenectar/box-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacenectar%2Fbox-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32350293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T17:12:42.749Z","status":"ssl_error","status_checked_at":"2026-04-27T17:12:41.658Z","response_time":128,"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":[],"created_at":"2024-11-19T05:48:10.388Z","updated_at":"2026-04-27T19:05:05.901Z","avatar_url":"https://github.com/spacenectar.png","language":"TypeScript","funding_links":["https://github.com/sponsors/foxleigh81","https://patreon.com/spacenectar","https://ko-fi.com/foxleigh81"],"categories":[],"sub_categories":[],"readme":"![Box Tracker Logo](/libs/assets/branding/box-tracker-logo-square.png)\n# Box Tracker\n\nWelcome to Box Tracker, the ultimate solution for organizing and tracking all your stuff in boxes, across multiple locations, and even with multiple users! This repo is structured as a monorepo managed by `Nx`, with separate folders for the backend (`NestJS`) and the frontend (`NextJS`).\n\n\n---\n\n## Table of Contents\n\n1. [Tech Stack](#tech-stack)\n2. [Project Structure](#project-structure)\n3. [Getting Started](#getting-started)\n4. [How to Navigate](#how-to-navigate)\n5. [Contributing](#contributing)\n\n---\n\n## Tech Stack\n\n- Frontend: `Next.js` (React) with TypeScript\n- Backend: `NestJS` (Node.js) with TypeScript\n- Database: `PostgreSQL` with Prisma ORM\n- Monorepo Management: `Nx`\n- Infrastructure:\n  - `Docker` for database containerization\n  - `tmux` for development environment management\n- Documentation: Markdown files in `/docs` and Storybook\n\n---\n\n## Project Structure\n\n```plaintext\nrepo/\n├─ projects/\n│  ├─ backend/        # NestJS backend service\n│  ├─ webapp/         # Next.js frontend service\n│  └─ storybook/      # Storybook documentation\n├─ libs/\n│  ├─ assets/         # Shared assets\n│  ├─ components/     # Shared UI components \n│  ├─ helpers/        # Shared helper functions\n│  ├─ mocks/          # Shared mock data\n│  ├─ theme/          # SCSS design system\n│  ├─ types/          # Shared TypeScript types\n│  └─ scripts/        # Build scripts and generators\n├─ docs/              # Project documentation\n├─ .env.example       # Environment variables (example)\n├─ docker-compose.yml # Docker setup for the database\n├─ devkit.sh          # Development environment script\n├─ nx.json            # Nx workspace configuration\n└─ package.json       # Shared scripts for Nx tasks\n```\n\n### /docs\n\nComplete project documentation, including architectural diagrams, technical decisions, and development setup guides.\n\n### /projects/webapp\n\nThe `Next.js` frontend application with TypeScript. Contains the user interface for the Box Tracker application.\n\n### /projects/backend\n\nThe `NestJS` backend that handles authentication, API endpoints, and database interactions using Prisma ORM.\n\n### /libs\n\nShared libraries and components that are used across projects, including UI components, design systems, and TypeScript types.\n\n---\n\n## Getting Started\n\n### Before you begin\n\n1. Clone the Repo\n\n   ```bash\n   git clone https://github.com/spacenectar/box-tracker.git\n   cd box-tracker\n   ```\n\n2. Ensure you have the following installed:\n   - Node.js (v22+) and Yarn\n   - Docker (for database only)\n   - tmux (optional, for DevKit)\n\n3. Copy `.env.example` to `.env` and update the values as needed.\n\n---\n\n### Running the Project\n\nBox Tracker provides several ways to run the development environment:\n\n1. **Standard Development**\n\n   ```bash\n   # Start both frontend and backend\n   yarn dev\n   ```\n\n   Note: This will start both the frontend and backend services, as well as the storybook instance and Prisma Studio, however it will not start the database.\n\n   ```bash\n   # Start the database\n   docker-compose up postgres\n   ```\n\n2. **DevKit Environment** (recommended)\n\n   ```bash\n   # Start the tmux-based development environment\n   yarn devkit\n   ```\n\n3. **Individual Services**\n\n   ```bash\n   # Start just the database\n   docker-compose up postgres\n   \n   # In another terminal, start the backend\n   yarn backend\n   \n   # In another terminal, start the frontend\n   yarn frontend\n   ```\n\nFor more detailed information about running the project, see the documentation:\n\n- [NX Monorepo Guide](./docs/development-setup/nx.md)\n- [Docker Setup](./docs/development-setup/docker.md)\n- [DevKit Environment](./docs/development-setup/devkit.md)\n\n---\n\n## How to Navigate\n\nYou can find more detailed information about various parts of the project in our documentation:\n\n- [Development Setup Documentation](./docs/development-setup): Guides for working with the monorepo, Docker, and DevKit\n- `docs/architectural-decisions/`: Technical decisions and implementation notes\n- `docs/coding-guidelines/`: Standards and best practices for code\n- `docs/design-guidelines/`: UI/UX standards and design system documentation\n- `projects/webapp/`: Next.js frontend application\n- `projects/backend/`: NestJS backend service\n- `libs/`: Shared libraries and components\n\n---\n\n## Contributing\n\nIf you want to help out, feel free to:\n\n1. Fork or clone this repo.\n2. Make your changes.\n3. Submit a pull request with a clear description of what you did.\n\nWe'll review and merge it if it looks good.\n\n---\n\nThanks for checking out Box Tracker! If you have questions, feature requests, or just want to rant about how unorganized your boxes are, open an issue or reach out. Let's build something awesome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacenectar%2Fbox-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacenectar%2Fbox-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacenectar%2Fbox-tracker/lists"}