European Tech Opportunities 2027 Documentation

← Project README · Contributing · Security policy · Privacy notice · Open the opportunity directory

Read this hub on GitHub or browse the searchable documentation. The live website is the primary interface for browsing opportunities. This documentation is the canonical reference for setup, CLI usage, search configuration, production operation, architecture, development, and project policies.

Start here

• Looking for a role? Open the live opportunity directory or read the website guide. Check eligibility, availability, and application details on the original listing before applying.
• Found a missing listing? Suggest an opportunity; suggestions are reviewed against the publication rules.
• Running locally? Start with installation and configuration.
• Using the CLI or changing searches? Read the CLI reference and search registry guide.
• Operating production? Use automation, database and lifecycle, Docker and deployment, and troubleshooting.
• Contributing? Read CONTRIBUTING.md, then use the development and architecture guides.

Setup

Guide	Use it when
Installation	Setting up Python, uv, Bun, SQLite, the local website, or optional Docker tooling.
Configuration	Configuring paths, limits, HTTP controls, logging, website settings, and authorization interlocks.

Using the project

Guide	Covers
Website	Search, filters, sorting, pagination, themes, sanitized CSV/JSON downloads, and read-only behavior.
CLI reference	Commands, options, side effects, network behavior, and exit codes.
Search registry	Search groups, YAML schema, validation, limit tiers, and query changes.

Operating production

Guide	Covers
Automation	Validation CI, scheduled collection, durable snapshots, artifacts, and VPS deployment.
Database and lifecycle	Schema, persistence, provenance, lifecycle state, migrations, backup, and restore.
Docker and deployment	Images, Compose, volumes, permissions, containers, and Dokploy.
Troubleshooting	Exit codes, common failures, diagnosis, and safe recovery.

Developing

Guide	Covers
Architecture	Complete data flow, component boundaries, classification, persistence, failure isolation, and projections.
Development	Repository workflow, implementation details, tests, fixtures, quality gates, and validation paths.

Project policies

Document	Covers
Contributing	Contributor workflow, coding expectations, validation, documentation rules, and pull-request requirements.
Security policy	Vulnerability reporting, source-access boundaries, trust boundaries, secrets, and safe operation.
Privacy notice	Directory and documentation hosting, analytics, browser storage, external services, and visitor choices.
Code of Conduct	Community standards, conduct reporting, and enforcement.

Visual assets

Screenshots, sanitized listing examples, and project identity assets live under docs/assets/:

assets/
├── listings/     # sanitized public listing examples
├── logo/         # project identity
└── sites/        # website previews

Documentation contributions should follow the documentation guidelines.