Send links and text between your devices. This repository contains:
- Web API: ASP.NET Core and Marten on PostgreSQL, hosted locally by .NET Aspire (
src/webapi) - Chrome extension: TypeScript, Manifest V3 (
src/chrome-extension) - Web app: TypeScript and Preact, with the landing, privacy and terms pages (
src/web) - Mobile app: Flutter for Android (
src/mobile_app)
You need the .NET 10 SDK, Docker and Node.js. Flutter and the Android SDK are only needed for mobile work, and the Dev Tunnels CLI only for a phone that is not on USB. The Atom build tool is pinned in dotnet-tools.json; dotnet tool restore installs it.
dotnet tool restore # installs the Atom build tool
dotnet atom SetupDevEnvironment # checks tools, prepares local config and packages
aspire run # or: dotnet run --project src/webapi/Invex.Passel.AppHost
The AppHost starts PostgreSQL, the API (https://localhost:7030), the extension's watch build and the web app (http://localhost:5245), and holds a dev tunnel you can start from the dashboard for a phone that is not on USB. The Google OAuth client values are optional for local work: without them the API accepts Authorization: Dev <user> instead of Google tokens.
The developer docs live in docs/ and build with DocFX:
dotnet atom ServeDocs # http://localhost:8080
Start with Prerequisites, Google OAuth Clients and Running Locally.
| Command | What it does |
|---|---|
dotnet atom Test |
Runs the Web API, extension and mobile test suites |
dotnet atom BuildWebApi / BuildChromeExtension / BuildMobileAppAndroid |
Release builds into atom-publish/ |
dotnet run --project _atom -- --help |
Lists every target and its parameters |
Branch and commit conventions, the pull request checklist and what CI runs are in CONTRIBUTING.md. Notable changes are listed in CHANGELOG.md. Passel is released under the MIT License.