{"id":50420480,"url":"https://github.com/robotdad/portfolio-builder","last_synced_at":"2026-05-31T08:02:20.978Z","repository":{"id":354555375,"uuid":"1141424976","full_name":"robotdad/portfolio-builder","owner":"robotdad","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-29T02:42:20.000Z","size":663206,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T04:31:50.910Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":false,"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/robotdad.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":"2026-01-24T20:33:57.000Z","updated_at":"2026-04-29T02:42:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/robotdad/portfolio-builder","commit_stats":null,"previous_names":["robotdad/portfolio-builder"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/robotdad/portfolio-builder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotdad%2Fportfolio-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotdad%2Fportfolio-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotdad%2Fportfolio-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotdad%2Fportfolio-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robotdad","download_url":"https://codeload.github.com/robotdad/portfolio-builder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotdad%2Fportfolio-builder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33723550,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2026-05-31T08:02:19.360Z","updated_at":"2026-05-31T08:02:20.970Z","avatar_url":"https://github.com/robotdad.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/branding/icons/icon-256.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"assets/branding/icons/icon-256.png\"\u003e\n    \u003cimg alt=\"Portfolio Builder\" src=\"assets/branding/icons/icon-256.png\" width=\"128\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n# Portfolio Builder\n\nA portfolio website builder designed for costume designers and creative professionals. Build and manage a beautiful portfolio with an intuitive admin interface.\n\n![Portfolio Builder](docs/images/hero-screenshot.png)\n\n---\n\n## Overview\n\nThis is a single-user portfolio application built with Next.js. It provides:\n\n- **Admin Dashboard** — Manage your portfolio content through a clean interface\n- **Theme System** — Three distinct visual themes to match your style\n- **Image Processing** — Automatic responsive image generation\n- **Draft/Publish Workflow** — Preview changes before going live\n- **Mobile-First Design** — Works beautifully on all devices\n\n### Themes\n\n| Theme | Description |\n|-------|-------------|\n| Modern Minimal | Clean lines, generous whitespace, understated elegance |\n| Classic Elegant | Traditional typography, refined details, timeless appeal |\n| Bold Editorial | High contrast, dramatic layouts, magazine-inspired |\n\n## Tech Stack\n\n- **Framework**: Next.js 16 (App Router)\n- **Database**: PostgreSQL via Prisma\n- **Styling**: Tailwind CSS 4\n- **Rich Text**: Tiptap editor\n- **Images**: Sharp.js for processing\n- **Storage**: Local filesystem or Azure Blob Storage\n\n## Quick Start\n\n### Prerequisites\n\n- Node.js 18+\n- npm or yarn\n- Docker Desktop (for local PostgreSQL)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/robotdad/portfolio-builder.git\ncd portfolio-builder\n\n# Install dependencies\nnpm install\n\n# Copy environment file\ncp .env.example .env.local\n\n# Start the local PostgreSQL database (required before anything else)\ndocker-compose up -d\n\n# Generate Prisma client\nnpm run db:generate\n\n# Create database and run migrations\nnpm run db:setup\n\n# Add your email to admin allowlist (REQUIRED for login)\nnpm run db:seed-admin your-email@gmail.com\n\n# Start the development server\nnpm run dev\n```\n\nThe app will be available at `http://localhost:3000`.\n\n### Daily Development\n\nIf you've already completed the initial setup and are returning to the project, you just need two steps:\n\n```bash\n# 1. Start the database (must be running before the dev server)\ndocker-compose up -d\n\n# 2. Start the development server\nnpm run dev\n```\n\nThe dev server requires a running PostgreSQL instance. If you see database connection errors, check that Docker is running and the postgres container is up (`docker ps`).\n\n### First Run\n\n1. Navigate to `http://localhost:3000`\n2. Sign in with Google using the email you added to the allowlist\n3. Create your portfolio with a name and choose a theme\n4. Add your first project with images\n5. Visit the admin dashboard at `/admin` to continue building\n\n### Optional: Populate with Test Data\n\nFor a fully-populated portfolio to explore:\n\n**Terminal 1 - Start server:**\n```bash\nnpm run dev\n```\n\n**Terminal 2 - Populate data:**\n```bash\n# Authenticate first (one-time, credentials are saved)\nnpm run auth:login  # Opens browser to sign in\nnpm run test:populate:sarah\n```\n\nThis creates a complete portfolio for costume designer Sarah Chen with categories, projects, and images.\n\n## Project Structure\n\n```\nportfolio/\n├── src/                    # Next.js application\n│   ├── app/               # App Router pages and API routes\n│   ├── components/        # React components\n│   ├── lib/               # Utilities and helpers\n│   └── prisma/            # Database schema and migrations\n├── scripts/               # Utility scripts\n├── test-assets/           # Test data and personas\n├── docs/                  # Documentation\n└── .amplifier/            # Agent tooling (DTU profiles, workspace memory)\n```\n\n## Scripts\n\nRun all commands from the project root:\n\n### Development\n\n| Command | Description |\n|---------|-------------|\n| `npm run dev` | Start development server |\n| `npm run build` | Build for production |\n| `npm run start` | Start production server |\n| `npm run lint` | Run ESLint |\n| `npm run format` | Format code with Prettier |\n\n### Database\n\n| Command | Description |\n|---------|-------------|\n| `npm run db:generate` | Generate Prisma client |\n| `npm run db:setup` | Create database and run migrations (initial setup) |\n| `npm run db:reset` | Reset local database (clear all tables) |\n| `npm run db:seed-admin \u003cemail\u003e` | Add an allowed admin email |\n| `npm run db:migrate:prod` | Run migrations on production |\n| `npm run db:reset:prod` | Reset production database |\n| `npm run db:seed-admin:prod \u003cemail\u003e` | Add admin email to production |\n\n### Testing\n\n| Command | Description |\n|---------|-------------|\n| `npm run test:e2e` | Run Playwright end-to-end tests |\n| `npm run test:e2e:ui` | Run tests with Playwright UI |\n| `npm run test:setup` | Setup DB + populate with Sarah Chen (requires server running) |\n| `npm run test:populate:sarah` | Populate with Sarah Chen test persona (requires server running) |\n| `npm run test:populate:sarah:prod` | Populate production with test persona |\n\n**Note:** Population scripts make API calls to the running server. Make sure Docker is running (`docker-compose up -d`), start `npm run dev` first, then run populate scripts in a separate terminal.\n\n### Authentication (for scripts)\n\n| Command | Description |\n|---------|-------------|\n| `npm run auth:login` | Authenticate for production scripts |\n| `npm run auth:status` | Check authentication status |\n| `npm run auth:logout` | Clear stored credentials |\n\n## Environment Variables\n\nCopy the example environment file:\n\n```bash\ncp .env.example .env\n```\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `DATABASE_URL` | PostgreSQL connection string | `postgresql://postgres:postgres@localhost:5432/portfolio` |\n| `AUTH_DISABLED` | Disable authentication for local dev | `false` (auth enabled) |\n\n## Documentation\n\n- [User Guide](docs/USER_GUIDE.md) — How to use the admin interface and manage your portfolio\n- [Architecture](docs/ARCHITECTURE.md) — System design overview\n- [API Reference](docs/API.md) — REST API documentation\n- [Testing Guide](docs/TESTING.md) — Test infrastructure, patterns, and DTU acceptance environment\n- [Deployment Guide](docs/DEPLOYMENT.md) — Azure Container Apps deployment\n\n## Test Data\n\nThe `scripts/` directory includes a population script for loading test personas:\n\n```bash\nnode scripts/populate-persona-api.js \u003cpersona-name\u003e\n```\n\nSee `test-assets/README.md` for available test personas and their content.\n\n## Deployment\n\nThis application is designed for single-user deployment on Azure Container Apps.\n\n**Architecture:**\n- Azure Container Apps (container hosting, managed TLS)\n- Azure Container Registry (private image storage)\n- Azure Database for PostgreSQL Flexible Server (VNet-private)\n- Azure Blob Storage for images\n- Google OAuth for authentication\n- GitHub Actions CI/CD with OIDC (no stored secrets)\n\n**Estimated cost:** ~$18-25/month.\n\nSee the [Deployment Guide](docs/DEPLOYMENT.md) for full instructions.\n\n## Contributing\n\nThis project is not currently accepting contributions. It serves as a demonstration project and personal portfolio solution.\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobotdad%2Fportfolio-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobotdad%2Fportfolio-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobotdad%2Fportfolio-builder/lists"}