@maudecode/kanvil 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kanvil contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="apps/web/public/brand/mark-white.svg">
+  <img src="apps/web/public/brand/mark-blue.svg" alt="Kanvil anvil" width="144" height="72">
+</picture>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Kanvil
+
+Open-source, self-hosted ticketing built around how agents discover, claim, update, and complete work, with web and native mobile apps for people.
+
+Kanvil owns its ticket data and runs on your infrastructure. It supports local login and generic OIDC; PocketID is covered by browser and iOS integration checks.
+
+## Status
+
+The standalone backend, web workspace, and native app are implemented. Self-hosting, recovery, and database/attachment restoration are tested. Native Release compilation has been verified on iOS Simulator and Android.
+
+See [self-hosting](docs/self-hosting.md), [agent/API interfaces](docs/api.md), [native builds](docs/mobile.md), and the [verification record](docs/verification.md).
+
+Projects can be grouped into separate [workspaces](docs/workspaces.md), with inherited or private access, library or uploaded project icons, and instance account administration.
+
+## Installation
+
+Install the app with `npm install --global @maudecode/kanvil`, or run `ghcr.io/maudecode/kanvil` with Docker Compose. Both need PostgreSQL 18. See [installation and upgrades](docs/self-hosting.md) for configuration, HTTPS, first-owner setup, and backups.
+
+[Releases](docs/releasing.md) describes version tags and the publishing workflow.
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and checks, and [AGENTS.md](AGENTS.md) for agent instructions.
+
+## Plan
+
+See the [delivery plan](docs/plan.md) for scope, chosen libraries, build order, and acceptance criteria.
+
+## License
+
+[MIT](LICENSE).

package/apps/server/.env.example

@@ -0,0 +1,41 @@
+DATABASE_URL=postgres://kanvil:kanvil@127.0.0.1:55462/kanvil
+KANVIL_URL=http://localhost:5180
+KANVIL_DATABASE=kanvil
+POSTGRES_PASSWORD=
+BETTER_AUTH_SECRET=
+KANVIL_SETUP_TOKEN=
+HOST=127.0.0.1
+PORT=5180
+# Additional browser development origins, comma-separated.
+KANVIL_TRUSTED_ORIGINS=http://localhost:5173
+# Write requests per minute allowed for one signed-in account before 429 responses.
+KANVIL_SESSION_WRITE_LIMIT=120
+# Configure all three OIDC values together. Omit them to use local login only.
+# OIDC_DISCOVERY_URL=https://identity.example.com/.well-known/openid-configuration
+# OIDC_CLIENT_ID=
+# OIDC_CLIENT_SECRET=
+# OIDC_NAME=PocketID
+# Optional native push delivery through Expo. Disabled by default.
+KANVIL_PUSH_ENABLED=false
+# EXPO_ACCESS_TOKEN=
+
+# Optional integrations. Omit the provider variables to configure them in Administration.
+# Explicit providers override the saved admin selection, including local/postgres.
+# KANVIL_STORAGE_PROVIDER=local
+# S3_ENDPOINT=https://s3.example.com
+# S3_REGION=us-east-1
+# S3_BUCKET=kanvil
+# S3_PREFIX=kanvil/
+# S3_FORCE_PATH_STYLE=true
+# S3_ACCESS_KEY_ID=
+# S3_SECRET_ACCESS_KEY=
+# KANVIL_SEARCH_PROVIDER=postgres
+# ELASTICSEARCH_URL=http://elasticsearch:9200
+# ELASTICSEARCH_INDEX=kanvil-instance
+# ELASTICSEARCH_AUTH=apiKey
+# ELASTICSEARCH_API_KEY=
+# ELASTICSEARCH_USERNAME=
+# ELASTICSEARCH_PASSWORD=
+# KANVIL_BROKER_PROVIDER=postgres
+# RABBITMQ_URL=amqps://kanvil:password@rabbitmq:5671/kanvil
+# RABBITMQ_EXCHANGE=kanvil.events