{"id":28612642,"url":"https://github.com/instructa/constructa-starter","last_synced_at":"2025-06-12T00:30:38.146Z","repository":{"id":298454096,"uuid":"999422528","full_name":"instructa/constructa-starter","owner":"instructa","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-11T07:16:23.000Z","size":499,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-11T07:40:30.576Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/instructa.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}},"created_at":"2025-06-10T08:20:51.000Z","updated_at":"2025-06-11T06:32:06.000Z","dependencies_parsed_at":"2025-06-11T07:40:52.915Z","dependency_job_id":"8a559115-34ba-45d8-8a2a-6092db5029c4","html_url":"https://github.com/instructa/constructa-starter","commit_stats":null,"previous_names":["instructa/constructa-starter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/instructa/constructa-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fconstructa-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fconstructa-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fconstructa-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fconstructa-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instructa","download_url":"https://codeload.github.com/instructa/constructa-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fconstructa-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259369542,"owners_count":22847092,"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":[],"created_at":"2025-06-12T00:30:37.236Z","updated_at":"2025-06-12T00:30:38.092Z","avatar_url":"https://github.com/instructa.png","language":"TypeScript","readme":"# 🚀 TanStack Starter\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\u003cstrong\u003eA modern React starter with shadcn/ui and Tailwind CSS 4\u003c/strong\u003e\u003c/p\u003e\n  \n  [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)](https://typescriptlang.org/)\n  [![React](https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB)](https://reactjs.org/)\n  [![TailwindCSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white)](https://tailwindcss.com/)\n\u003c/div\u003e\n\n## ✨ Features\n\n- **[TanStack Start](https://tanstack.com/start)** - Modern full-stack React framework\n- **[shadcn/ui](https://ui.shadcn.com/)** - Beautiful, accessible component library\n- **[Tailwind CSS v4](https://tailwindcss.com/)** - Modern utility-first CSS framework\n- **[TypeScript](https://typescriptlang.org/)** - Full type safety\n- **[TanStack Router](https://tanstack.com/router)** - Type-safe file-based routing\n\n## 🚀 Quick Start\n\n### Prerequisites\n- **Node.js** 18+ \n- **pnpm** (recommended package manager)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone \u003cyour-repo-url\u003e\ncd tanstack-starter-instructa\n\n# Install dependencies\npnpm install\n\n# Start development server\npnpm dev\n```\n\n### Available Scripts\n\n```bash\n# Development\npnpm dev          # Start development server\npnpm build        # Build for production\npnpm start        # Start production server\n\n# Code Quality\npnpm biome:check  # Check code formatting and linting\npnpm biome:fix:unsafe # Fix code issues (unsafe)\n```\n\n## 📁 Project Structure\n\n```\nsrc/\n├── app/\n│   ├── routes/           # File-based routing\n│   │   ├── __root.tsx   # Root layout\n│   │   ├── index.tsx    # Home page\n│   │   └── api/         # API routes\n│   └── styles/          # Global styles\n├── components/\n│   └── ui/              # shadcn/ui components\n└── utils/               # Utility functions\n```\n\n## 🎯 Core Technologies\n\n| Technology | Purpose | Documentation |\n|------------|---------|---------------|\n| **TanStack Start** | Full-stack framework | [Docs](https://tanstack.com/start) |\n| **shadcn/ui** | Component library | [Docs](https://ui.shadcn.com/) |\n| **Tailwind CSS v4** | Styling framework | [Docs](https://tailwindcss.com/) |\n| **TypeScript** | Type safety | [Docs](https://typescriptlang.org/) |\n\n## 🔧 Configuration\n\n### Environment Variables\n\nCreate a `.env` file in the root directory based on `.env.example`:\n\n```bash\n# Database\nDATABASE_URL=\"postgresql://username:password@localhost:5432/constructa\"\n\n# Client-side Base URL (optional - defaults to current origin in production)\nVITE_BASE_URL=\"http://localhost:3000\"\n\n# OAuth Providers (optional)\nGITHUB_CLIENT_ID=\"your-github-client-id\"\nGITHUB_CLIENT_SECRET=\"your-github-client-secret\"\nGOOGLE_CLIENT_ID=\"your-google-client-id\"\nGOOGLE_CLIENT_SECRET=\"your-google-client-secret\"\n```\n\n- `VITE_BASE_URL` is optional - in production, it will automatically use the current domain\n- For local development, it defaults to `http://localhost:3000`\n\n### Adding shadcn/ui Components\n```bash\n# Add new components\nnpx shadcn@latest add button\nnpx shadcn@latest add card\nnpx shadcn@latest add input\n```\n\n### Tailwind CSS\n- Uses Tailwind CSS v4 with modern CSS-first configuration\n- Configured in `app.config.ts`\n- Global styles in `src/app/styles/`\n\n### TypeScript\n- **Path aliases**: `@` resolves to the root `./` directory\n- **Route files**: Must use `.tsx` extension\n\n## 🚀 Deployment\n\n### Build for Production\n```bash\npnpm build\n```\n\n### Start Production Server\n```bash\npnpm start\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eBuilt with ❤️ using modern React tools\u003c/p\u003e\n\u003c/div\u003e\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstructa%2Fconstructa-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstructa%2Fconstructa-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstructa%2Fconstructa-starter/lists"}