https://github.com/kiwunaka/pokrov-client
Open-source POKROV client app foundation for Android and Windows.
https://github.com/kiwunaka/pokrov-client
android client flutter gplv3 open-source pokrov vpn windows
Last synced: 18 days ago
JSON representation
Open-source POKROV client app foundation for Android and Windows.
- Host: GitHub
- URL: https://github.com/kiwunaka/pokrov-client
- Owner: Kiwunaka
- License: gpl-3.0
- Created: 2026-06-05T10:21:07.000Z (23 days ago)
- Default Branch: main
- Last Pushed: 2026-06-05T11:31:12.000Z (23 days ago)
- Last Synced: 2026-06-05T12:23:19.291Z (23 days ago)
- Topics: android, client, flutter, gplv3, open-source, pokrov, vpn, windows
- Homepage: https://pokrov.space
- Size: 4.15 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
- Governance: docs/GOVERNANCE.md
- Roadmap: ROADMAP.md
- Notice: NOTICE
Awesome Lists containing this project
README
# POKROV Client
An open client for a calm, app-first connection experience.
Android and Windows first. GPLv3. Sanitized source snapshot imported.
Language index
·
Русский
·
Scope
·
Security
·
Brand
---
## What This Is
POKROV Client is the public source home for the POKROV Android and Windows
client app.
The repository contains the public project structure, contribution rules,
security policy, release policy, brand boundary, source-import checklist, and
the first sanitized Android + Windows client source snapshot.
## Product Modes
- Community client: neutral, no POKROV branding, no POKROV API calls by
default, local import for single `vless://`, `trojan://`, `ss://`, and
`vmess://` keys, local multi-profile selection, subscription URL import and
refresh, Android/Windows QR import, and gated third-party catalog metadata.
- Operator client: a white-label path for companies that want to connect the
app to their own backend, billing, support, and brand.
- POKROV service mode: reserved for official POKROV builds and official
POKROV service endpoints.
The optional free VPN catalog remains disabled by default and must stay clearly
labeled as third-party public configs.
## Status
| Area | Current state |
| --- | --- |
| Repository | Public foundation ready |
| Source code | Sanitized Android + Windows snapshot imported |
| Community mode | Local profiles, manual subscription import, decoded QR import |
| Operator mode | White-label contracts documented |
| Platforms | Android and Windows first |
| License | GNU GPLv3 |
| Official backend | Operated separately by POKROV |
| Public releases | Beta-safe claims only |
## Architecture Boundary
This repository is for the client app. It does not contain the official POKROV
backend, billing system, admin tools, deployment scripts, signing material,
private release evidence, or operator runbooks.
Read [docs/OPEN_SOURCE_SCOPE.md](docs/OPEN_SOURCE_SCOPE.md) for the full
boundary.
## Repository Map
```text
.
|-- README.md Language gateway
|-- README.en.md English project README
|-- README.ru.md Russian project README
|-- apps/ Android and Windows Flutter hosts
|-- packages/ Shared Flutter packages
|-- config/ Public seed config and runtime contracts
|-- scripts/ Local bootstrap, runtime-fetch, and test scripts
|-- BRAND.md Brand and official-build boundary
|-- SECURITY.md Private security-reporting process
|-- CONTRIBUTING.md Contribution rules
|-- ROADMAP.md Public repository roadmap
|-- docs/
| |-- OPEN_SOURCE_SCOPE.md
| |-- RELEASE_POLICY.md
| |-- DEPENDENCY_LICENSE_AUDIT.md
| |-- MAINTAINER_CHECKLIST.md
| |-- PROJECT_PRINCIPLES.md
| |-- SOURCE_IMPORT_PLAYBOOK.md
| |-- PRODUCT_VARIANTS.md
| |-- OPERATOR_INTEGRATION.md
| `-- GOVERNANCE.md
`-- assets/
|-- brand/
`-- diagrams/
```
## Build From Source
Build instructions are available in
[docs/BUILD_FROM_SOURCE.md](docs/BUILD_FROM_SOURCE.md).
Source import tooling is available for maintainers:
```powershell
python -m pytest tests/test_source_import.py
python -m tools.source_import.safe_import --source --staging --manifest
```
Clean-clone verification is available for maintainers:
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\verify-clean-clone.ps1
```
The acceptance bar for source work is simple:
- a clean clone must build without private files
- no secrets, certificates, or signing identities may be required
- configuration examples must use placeholders
- official release metadata must not point to private repositories
## Contributing
Contributions are welcome, especially around documentation, release hygiene,
build reproducibility, local profile import, operator integration, and
public-source readiness.
Before contributing, read:
- [CONTRIBUTING.md](CONTRIBUTING.md)
- [SECURITY.md](SECURITY.md)
- [BRAND.md](BRAND.md)
- [docs/MAINTAINER_CHECKLIST.md](docs/MAINTAINER_CHECKLIST.md)
- [docs/PROJECT_PRINCIPLES.md](docs/PROJECT_PRINCIPLES.md)
- [docs/SOURCE_IMPORT_PLAYBOOK.md](docs/SOURCE_IMPORT_PLAYBOOK.md)
- [docs/PRODUCT_VARIANTS.md](docs/PRODUCT_VARIANTS.md)
- [docs/OPERATOR_INTEGRATION.md](docs/OPERATOR_INTEGRATION.md)
- [docs/FREE_VPN_CATALOG_GATE.md](docs/FREE_VPN_CATALOG_GATE.md)
- [docs/RELEASE_CHECKLIST.md](docs/RELEASE_CHECKLIST.md)
- [docs/GOVERNANCE.md](docs/GOVERNANCE.md)
Please do not open public issues with secrets, personal connection links,
private backend details, account data, or vulnerability reproduction details.
## Official Links
- Website: https://pokrov.space/
- Cabinet: https://app.pokrov.space/
- Public channel: https://t.me/pokrov_vpn
- Support bot: https://t.me/pokrov_supportbot
Official binaries are published only through POKROV-owned release channels.
Forks and rebuilt clients must not imply that they are official POKROV builds.
## License
This repository is licensed under the GNU General Public License v3.0. See
[LICENSE](LICENSE).
The POKROV name, logos, domains, official channels, signing identities, and
release distribution channels are governed separately by [BRAND.md](BRAND.md).