Basic repo files

Author: aidankhogg

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,26 @@
+---
+name: Bug report
+about: Something isn't working correctly
+labels: bug
+---
+
+## What happened?
+
+<!-- Describe the bug clearly. What did you see? What did you expect to see? -->
+
+## Steps to reproduce
+
+1. 
+2. 
+3. 
+
+## Environment
+
+- Python version:
+- OS:
+- Browser (if relevant):
+- Version / commit:
+
+## Additional context
+
+<!-- Screenshots, logs, error messages, anything else relevant. -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature request
+about: Suggest something new
+labels: feature
+---
+
+## What's the problem or opportunity?
+
+<!-- Describe the context. What are you trying to do, or what's missing? -->
+
+## What would you like to happen?
+
+<!-- Describe the feature. What should it do? -->
+
+## Alternatives considered
+
+<!-- Any other approaches you've thought about? Why is this better? -->
+
+## Additional context
+
+<!-- Mockups, examples, links, anything else. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## What does this do?
+
+<!-- One or two sentences. What changed and why. -->
+
+## How to test it
+
+<!-- Steps to verify this works. Include edge cases worth checking. -->
+
+1. 
+2. 
+3. 
+
+## Checklist
+
+- [ ] Tests pass locally (`pytest`)
+- [ ] Pre-commit hooks pass (`pre-commit run --all-files`)
+- [ ] Type hints added or updated where relevant
+- [ ] CHANGELOG.md updated under `[Unreleased]` (user-facing changes only)
+- [ ] Linked to relevant issue(s) below
+
+## Related
+
+<!-- Use "Closes #123" to auto-close the issue when this merges. -->
+<!-- Use "Relates to #124" for issues this touches but doesn't close. -->

.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --cov=src --cov-report=term-missing
+
+  lint:
+    name: Lint & format
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: black
+        run: black --check .
+
+      - name: isort
+        run: isort --check-only .
+
+      - name: flake8
+        run: flake8 .
+
+      - name: mypy
+        run: mypy src/

.github/workflows/release.yml

@@ -0,0 +1,27 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0          # full history so changelog diff works
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true   # auto-generates from merged PRs
+          draft: false
+          prerelease: ${{ contains(github.ref_name, '-') }}
+          # A tag like v1.0.0-beta.1 (contains a dash) is marked pre-release.
+          # A tag like v1.0.0 is marked as a full release.

.gitignore

@@ -0,0 +1,72 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyo
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+coverage.xml
+*.cover
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Linting
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Environment variables — never commit secrets
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+logs/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Node (if you have any frontend tooling)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build outputs
+*.pyc
+*.pyd

CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+Changes on `develop` that haven't been released yet.
+
+### Added
+
+- (add entries here as features land on develop)
+
+### Changed
+
+-
+
+### Fixed
+
+-
+
+---
+
+## [0.2.0] — 2026-06-15
+
+### Added
+
+- Event registration form for Untasting events (#42)
+- Email confirmation on successful registration (#43)
+- Attendee list view in admin panel (#44)
+- Capacity limit enforcement on event registration (#46)
+
+### Changed
+
+- Improved mobile layout on the homepage (#39)
+- Updated product card design to match new brand guidelines (#40)
+
+### Fixed
+
+- Registration form submitted twice on slow connections (#45)
+- Email sender name showing raw address instead of display name (#47)
+
+---
+
+## [0.1.0] — 2026-05-01
+
+Initial release.
+
+### Added
+
+- Product catalogue with no/low alcohol category
+- Basic storefront and product detail pages
+- Contact page
+- Initial brand and visual identity
+
+---
+
+<!-- Links — keep these at the bottom, update on every release -->
+[Unreleased]: https://github.com/sober-and-co/sober-and-co/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/sober-and-co/sober-and-co/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/sober-and-co/sober-and-co/releases/tag/v0.1.0