···11name: "Feature Request"
22-description: "Suggest an idea for the Bitchsky app."
22+description: "Suggest an idea for the Witchsky app."
33labels: ["feature-request"]
44body:
55 - type: markdown
···11-# Bitchsky Social App 🧙
11+# Witchsky Social App 🧙 (WIP)
2233-Hey, bitches! This is the codebase for the Bitchsky app, based on [social.daniela.lol](https://github.com/kittibytess/deer-social) and prior [Bluesky](https://github.com/bluesky-social/social-app) forks.
33+Hey, witches! This is the codebase for the Witchsky app, based on [social.daniela.lol](https://github.com/kittibytess/deer-social) and prior [Bluesky](https://github.com/bluesky-social/social-app) forks.
4455Get the app itself:
6677-- **Web: [bitchsky.app](https://bitchsky.app)**
88-- **iOS: [Soon™](https://large-type.com/#%F0%9F%99%80)?**
99-- **Android: [Github Releases](https://github.com/jollywhoppers/bitchsky-app/releases/latest)**
77+- **Web: [witchsky.app](https://witchsky.app)**
88+- **iOS: [Soon™](https://cat-bounce.com/)?**
99+- **Android: [F-Droid repo](https://app.jolly.you/fdroid/repo)**
10101111-<a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/jollywhoppers/bitchsky-app/">
1111+<a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/jollywhoppers/witchsky-app/">
1212<img src="https://github.com/ImranR98/Obtainium/blob/main/assets/graphics/badge_obtainium.png?raw=true"
1313alt="Get it on Obtainium" align="center" height="54" /></a>
14141515## Improvements on Bluesky
16161717-- Funner name (still love you tho bsky!)
1717+- Cooler name (still love you tho bsky!)
1818- Nicer colors (kinda like gruvbox? not really)
1919- Posts are called Skeets
2020-- Share links to bitchsky.app or bsky.app
2020+- Choose between sharing witchsky.app or bsky.app links
2121- Embed player works with [stream.place](https://stream.place/) links!
2222-- Open skeets in PDSls and original pages from bridged posts
2222+- Open skeets in PDSls and original pages of bridged posts
2323- Better defaults (alt text required 😉)
2424- More unique repost icons
2525- No push notifications (may be added later)
···73737474### TODO: Xan
75757676-- [ ] Update branding (especially colors and app icon) to Bitchsky
7676+- [ ] Update branding (especially colors and app icon) to Witchsky
7777 - [ ] ./src/components/WelcomeModal.tsx (tab/hover selector)
7878 - [ ] ./src/alf/themes.ts (improve contrast, esp. of links)
7979 - [ ] ./src/lib/styles.ts (change likes color, remove gradient from new skeet button)
8080 - [ ] ./src/style.css (change links color)
8181 - [ ] ./src/view/com/util/UserAvatar.tsx (change #0070FF)
8282- - [ ] ./assets/app-icons/ (change new bksy logos to fit Bitchsky -remove from social embed!)
8383- - [ ] social embed stuff (bitchsky logo in image with jollywhoppers logo, use bitchsky icon)
8282+ - [ ] ./assets/app-icons/ (change new bksy logos to fit Witchsky -remove from social embed!)
8383+ - [ ] social embed stuff (witchsky logo in image with jollywhoppers logo, use witchsky icon)
8484- [ ] Setup App Linking for Android (.well-known w/ app package fingerprint)
8585-- [ ] Automatic PDS detection like other social-app forks (fallback/email addresses to use bitchsky.social)
8585+- [ ] Automatic PDS detection like other social-app forks (fallback/email addresses to use witchsky.social)
8686- [ ] Like of or repost of repost icons in notifications
8787- [ ] Change followed accounts [on onboarding](https://github.com/blacksky-algorithms/blacksky.community/commit/e36ee43efb4999f070860d7f70122e45b28c1e2b)
8888- [ ] Join date & switch accounts from composer from a fork like [deer.aylac.top](https://github.com/ayla6/deer-social-test)
8989-- [ ] Visual replies indicator like the [Firmament userstyle](https://bitchsky.app/profile/did:plc:jwhxcrf5uvl3vyw7nurecgt5/post/3m4rr3vzmak2a) (and likes?)
8989+- [ ] Visual replies indicator like the [Firmament userstyle](https://witchsky.app/profile/did:plc:jwhxcrf5uvl3vyw7nurecgt5/post/3m4rr3vzmak2a) (and likes?)
9090- [ ] Additional translation service providers + setting (Deepl, Kagi)
9191- [ ] Move Mutuals label to the follow button
9292- [ ] Put DeerSettings into separate subpages
9393-- [ ] After subpages for options, add [Outlinks page](https://bitchsky.app/profile/did:plc:q7suwaz53ztc4mbiqyygbn43/post/3m5zjhhshic2g) &
9393+- [ ] After subpages for options, add [Outlinks page](https://witchsky.app/profile/did:plc:q7suwaz53ztc4mbiqyygbn43/post/3m5zjhhshic2g) &
9494 - [ ] ShareMenuItems.tsx, ShareMenuItems.web.tsx
9595- [ ] For profile meatball button, Open profile in PDSls & Open bridged OG fedi account page
9696 - [ ] ProfileMenu.tsx
9797-- [ ] Bitchsky PDS and .social site (list good songs containing 'bitch' in their titles)
9797+- [ ] Witchsky PDS and .social site (list good songs containing 'bitch' in their titles)
98989999### Even more wishful or far off
100100···110110111111This is a [React Native](https://reactnative.dev/) application, written in the TypeScript programming language. It builds on the `atproto` TypeScript packages (like [`@atproto/api`](https://www.npmjs.com/package/@atproto/api)), which are also open source, but in [a different git repository](https://github.com/bluesky-social/atproto).
112112113113-There is vestigial Go language source code (in `./bskyweb/`), for a web service that returns the React Native Web application in the social app deployment. However, it is not used in current Bitchsky deployments.
114114-For Bitchsky, the intended deployment is with a webserver that can serve static files, and reroute to `index.html` as needed. [Bitchsky](https://bitchsky.app) is currently hosted on [Cloudflare Pages](https://pages.cloudflare.com/).
113113+There is vestigial Go language source code (in `./bskyweb/`), for a web service that returns the React Native Web application in the social app deployment. However, it is not used in current Witchsky deployments.
114114+For Witchsky, the intended deployment is with a webserver that can serve static files, and reroute to `index.html` as needed. [Witchsky](https://witchsky.app) is currently hosted on [Cloudflare Pages](https://pages.cloudflare.com/).
115115116116The [Build Instructions](./docs/build.md) are a good place to get started with the app itself. If you use nix (and especially direnv) then `flake.nix` will get you a working environment for the web version of the app.
117117118118The Authenticated Transfer Protocol ("AT Protocol" or "atproto") is a decentralized social media protocol. You don't *need* to understand AT Protocol to work with this application, but it can help.
119119-You may wish to reference [resources linked in social-app](https://github.com/bluesky-social/social-app#development-resources). However, please don't harass the Bluesky team with issues or questions pertaining to Bitchsky.
119119+You may wish to reference [resources linked in social-app](https://github.com/bluesky-social/social-app#development-resources). However, please don't harass the Bluesky team with issues or questions pertaining to Witchsky.
120120121121-Bitchsky is a fork of the official Bluesky client, social-app. It encompasses a set of schemas and APIs built in the overall AT Protocol framework. The namespace for these "Lexicons" is `app.bsky.*`.
121121+Witchsky is a fork of the official Bluesky client, social-app. It encompasses a set of schemas and APIs built in the overall AT Protocol framework. The namespace for these "Lexicons" is `app.bsky.*`.
122122123123## Contributions
124124125125-> Bitchsky is a community fork, and we'd love to merge your PR!
125125+> Witchsky is a community fork, and we'd love to merge your PR!
126126127127-As a rule of thumb, the best features for Bitchsky are those that have a disproportionately positive impact on the user experience compared to the maintenance overhead. Unlike some open source projects, since Bitchsky is a soft fork, any features (patches) we add on top of upstream social-app need to be maintained. For example, a change to the way skeets are composed may be very invasive, touching lots of code across the codebase. If upstream refactors this component, we will need to rewrite this feature to be compatible or drop it from the client.
127127+As a rule of thumb, the best features for Witchsky are those that have a disproportionately positive impact on the user experience compared to the maintenance overhead. Unlike some open source projects, since Witchsky is a soft fork, any features (patches) we add on top of upstream social-app need to be maintained. For example, a change to the way skeets are composed may be very invasive, touching lots of code across the codebase. If upstream refactors this component, we will need to rewrite this feature to be compatible or drop it from the client.
128128129129For this reason, only features that require changing only a small amount of code from upstream should be considered.
130130131131-Without an overriding motivation, opinionated features should exist behind a toggle that is not enabled by default. This allows Bitchsky to cater to as many users as possible.
131131+Without an overriding motivation, opinionated features should exist behind a toggle that is not enabled by default. This allows Witchsky to cater to as many users as possible.
132132133133### Guidelines
134134···148148149149Please be sure to:
150150151151-- Change all branding in the repository and UI to clearly differentiate from Bitchsky.
151151+- Change all branding in the repository and UI to clearly differentiate from Witchsky.
152152- Change any support links (feedback, email, terms of service, issue tracker, etc) to your own systems.
153153154154## Self hosting & personal builds
155155156156-Self hosting is great! It is our intention that Bitchsky is easy to self host and build on your own. If you host your own instance of Bitchsky, or make your own builds, please make some level of effort to clarify that it is not an "official" build or instance. This can be in the form of a different domain or branding, but can also be as simple as not advertising your hosted instance or builds as "official" releases.
156156+Self hosting is great! It is our intention that Witchsky is easy to self host and build on your own. If you host your own instance of Witchsky, or make your own builds, please make some level of effort to clarify that it is not an "official" build or instance. This can be in the form of a different domain or branding, but can also be as simple as not advertising your hosted instance or builds as "official" releases.
157157158158## Security disclosures
159159160160If you discover any security issues, please privately disclose them to [xan.lol](https://xan.lol/).
161161-If the issue pertains to infastructure, code, or systems outside the scope of Bitchsky, please refer to the [disclosure guidelines on social-app](https://github.com/bluesky-social/social-app#security-disclosures) if it is hosted by Bluesky PBC. Otherwise, reference the security policy of that system as applicable <3
161161+If the issue pertains to infastructure, code, or systems outside the scope of Witchsky, please refer to the [disclosure guidelines on social-app](https://github.com/bluesky-social/social-app#security-disclosures) if it is hosted by Bluesky PBC. Otherwise, reference the security policy of that system as applicable <3
162162163163## License (MIT)
164164···168168169169## P.S.
170170171171-We ❤️ you and all of the ways you support us. Thank you for making Bluesky & Bitchsky so great! ^.^
171171+We ❤️ you and all of the ways you support us. Thank you for making Bluesky & Witchsky so great! ^.^
···981981982982describe('createStarterPackGooglePlayUri', () => {
983983 const base =
984984- 'https://play.google.com/store/apps/details?id=app.bitchsky&referrer=utm_source%3Dbluesky%26utm_medium%3Dstarterpack%26utm_content%3Dstarterpack_'
984984+ 'https://play.google.com/store/apps/details?id=app.witchsky&referrer=utm_source%3Dbluesky%26utm_medium%3Dstarterpack%26utm_content%3Dstarterpack_'
985985986986 it('returns valid google play uri when input is valid', () => {
987987 expect(createStarterPackGooglePlayUri('name', 'rkey')).toEqual(
···1111 name="viewport"
1212 content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1.00001, viewport-fit=cover"
1313 />
1414- <title>Privacy Policy — Bitchsky</title>
1414+ <title>Privacy Policy — Witchsky</title>
15151616 <link rel="preload" as="font" type="font/woff2" href="/static/media/InterVariable.c504db5c06caaf7cdfba.woff2" crossorigin>
1717···2222 <body>
232324242525- <h1>Bitchsky Privacy Policy</h1>
2525+ <h1>Witchsky Privacy Policy</h1>
26262727 <p><em><strong>Last Updated:</strong> May 07, 2025</em></p>
28282929- <p>Welcome to Bitchsky. This privacy policy explains our approach to your data when you use our application.</p>
2929+ <p>Welcome to Witchsky. This privacy policy explains our approach to your data when you use our application.</p>
30303131- <h2>No Data Collection by Bitchsky</h2>
3232- <p><strong>The Bitchsky application itself does not collect, store, track, or share any of your personal information or user data.</strong> We do not operate servers that store your account details, posts, or activity logs.</p>
3131+ <h2>No Data Collection by Witchsky</h2>
3232+ <p><strong>The Witchsky application itself does not collect, store, track, or share any of your personal information or user data.</strong> We do not operate servers that store your account details, posts, or activity logs.</p>
3333 <p>Our application functions solely as a client interface to interact with the underlying Bluesky social network (AT Protocol).</p>
34343535 <h2>Reliance on Third-Party Services (AppView and PDS)</h2>
3636- <p>When you use Bitchsky, you connect to the Bluesky network through a specific AppView and your chosen Personal Data Server (PDS). These services are responsible for storing and managing your account information, posts, social graph, and other associated data.</p>
3737- <p><strong>Your data handling and privacy are governed by the Terms of Service and Privacy Policies of the specific AppView and PDS you use.</strong> Bitchsky simply acts on your behalf to communicate with these services based on the credentials you provide locally on your device.</p>
3636+ <p>When you use Witchsky, you connect to the Bluesky network through a specific AppView and your chosen Personal Data Server (PDS). These services are responsible for storing and managing your account information, posts, social graph, and other associated data.</p>
3737+ <p><strong>Your data handling and privacy are governed by the Terms of Service and Privacy Policies of the specific AppView and PDS you use.</strong> Witchsky simply acts on your behalf to communicate with these services based on the credentials you provide locally on your device.</p>
3838 <p>We strongly recommend you review the policies of your chosen PDS provider and the AppView you are using. For reference, the Privacy Policy for the default Bluesky service (AppView provided by <a href="https://bsky.social" target="_blank" rel="noopener noreferrer">bsky.social</a>) can be found here:</p>
3939 <p><a href="https://bsky.social/about/support/privacy-policy" target="_blank" rel="noopener noreferrer">https://bsky.social/about/support/privacy-policy</a></p>
40404141 <h2>Data Stored Locally on Your Device</h2>
4242- <p>To function, Bitchsky may store your login credentials or temporary session information on your own device. This data is not accessed by or transmitted to us.</p>
4242+ <p>To function, Witchsky may store your login credentials or temporary session information on your own device. This data is not accessed by or transmitted to us.</p>
43434444 <h2>Cookies and Analytics</h2>
4545- <p>Bitchsky does not use cookies or any tracking analytics.</p>
4545+ <p>Witchsky does not use cookies or any tracking analytics.</p>
46464747 <h2>Changes to This Policy</h2>
4848 <p>We may update this policy. If we do, we will update the "Effective Date" at the top of this page.</p>
49495050 <h2>Contact Us</h2>
5151- <p>If you have questions specifically about the functionality of the Bitchsky application itself (and not about data managed by your PDS or AppView), please email <a href="mailto:contact@jollywhoppers.com" target="_blank" rel="noopener noreferrer">contact@jollywhoppers.com</a>.</p>
5151+ <p>If you have questions specifically about the functionality of the Witchsky application itself (and not about data managed by your PDS or AppView), please email <a href="mailto:contact@jollywhoppers.com" target="_blank" rel="noopener noreferrer">contact@jollywhoppers.com</a>.</p>
52525353 </body>
5454</html>
···1111 name="viewport"
1212 content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1.00001, viewport-fit=cover"
1313 />
1414- <title>Terms of Service — Bitchsky</title>
1414+ <title>Terms of Service — Witchsky</title>
15151616 <link rel="preload" as="font" type="font/woff2" href="/static/media/InterVariable.c504db5c06caaf7cdfba.woff2" crossorigin>
1717···2222 <body>
232324242525-<h1>Terms of Service for Bitchsky</h1>
2525+<h1>Terms of Service for Witchsky</h1>
26262727<p><em><strong>Last Updated:</strong> May 07, 2025</em></p>
28282929<h2>Introduction</h2>
3030-<p>Welcome to Bitchsky! These Terms of Service ("Terms") govern your use of the Bitchsky application ("App"). By accessing or using the App, you agree to be bound by these Terms.</p>
3030+<p>Welcome to Witchsky! These Terms of Service ("Terms") govern your use of the Witchsky application ("App"). By accessing or using the App, you agree to be bound by these Terms.</p>
31313232<h2>Your Agreement</h2>
3333-<p>Using Bitchsky signifies your acceptance of these Terms. Please also review our <a href="/privacy">Privacy Policy</a>, which explains how we handle data related to the App itself.</p>
3333+<p>Using Witchsky signifies your acceptance of these Terms. Please also review our <a href="/privacy">Privacy Policy</a>, which explains how we handle data related to the App itself.</p>
34343535<h2>Relationship to Other Services and Platforms</h2>
3636-<p>Bitchsky functions as a client or interface. It allows you to interact with decentralized social media protocols, instances, or servers (your "AppView" or "Personal Data Server" / "PDS").</p>
3737-<p><strong>Important:</strong> Bitchsky does not host your data or control the underlying networks or servers you connect to. Your interaction with these third-party services, including the content you post and view, is governed by the Terms of Service, acceptable use policies, and privacy policies of the specific AppView and/or PDS you choose to use.</p>
3636+<p>Witchsky functions as a client or interface. It allows you to interact with decentralized social media protocols, instances, or servers (your "AppView" or "Personal Data Server" / "PDS").</p>
3737+<p><strong>Important:</strong> Witchsky does not host your data or control the underlying networks or servers you connect to. Your interaction with these third-party services, including the content you post and view, is governed by the Terms of Service, acceptable use policies, and privacy policies of the specific AppView and/or PDS you choose to use.</p>
3838<p>You are responsible for understanding and complying with the terms of those external services.</p>
39394040<p>We strongly recommend you review the policies of your chosen PDS provider and the AppView you are using. For reference, the Terms of Service for the default Bluesky service (AppView provided by <a href="https://bsky.social" target="_blank" rel="noopener noreferrer">bsky.social</a>) can be found here: </p>
4141<p><a href="https://bsky.social/about/support/tos" target="_blank" rel="noopener noreferrer">https://bsky.social/about/support/tos</a></p>
42424343<h2>User Conduct</h2>
4444-<p>Your conduct while using Bitchsky must comply with the terms and rules set forth by the AppView and PDS you are connected to. Bitchsky is merely a tool to access these services, and Jollywhoppers is not responsible for enforcing the rules of those platforms or for the content accessed through them.</p>
4444+<p>Your conduct while using Witchsky must comply with the terms and rules set forth by the AppView and PDS you are connected to. Witchsky is merely a tool to access these services, and Jollywhoppers is not responsible for enforcing the rules of those platforms or for the content accessed through them.</p>
45454646<h2>Disclaimer of Warranty</h2>
4747<p>The App is provided "AS IS" and "AS AVAILABLE," without warranty of any kind, express or implied. Forsyth Peak LLC does not warrant that the App will meet your requirements, be available uninterrupted, secure, or error-free.</p>
···6060```sh
6161> npx eas build:version:set -p ios
6262>
6363-> Project @blueskysocial/bluesky with bundle identifier "app.bitchsky" is configured with buildNumber 1011.
6363+> Project @blueskysocial/bluesky with bundle identifier "app.witchsky" is configured with buildNumber 1011.
6464> ✔ What version would you like to set? … 1009
6565>
6666> npx eas build:version:set -p android
6767>
6868-> Project @blueskysocial/bluesky with application ID "app.bitchsky" is configured with versionCode 641.
6868+> Project @blueskysocial/bluesky with application ID "app.witchsky" is configured with versionCode 641.
6969> ✔ What version would you like to set? … 639
7070```
7171···124124```sh
125125> npx eas build:version:set -p ios
126126>
127127-> Project @blueskysocial/bluesky with bundle identifier "app.bitchsky" is configured with buildNumber 1009.
127127+> Project @blueskysocial/bluesky with bundle identifier "app.witchsky" is configured with buildNumber 1009.
128128> ✔ What version would you like to set? … 1011
129129>
130130> npx eas build:version:set -p android
131131>
132132-> Project @blueskysocial/bluesky with application ID "app.bitchsky" is configured with versionCode 639.
132132+> Project @blueskysocial/bluesky with application ID "app.witchsky" is configured with versionCode 639.
133133> ✔ What version would you like to set? … 641
134134```
135135
···11import UserNotifications
22import UIKit
3344-let APP_GROUP = "group.app.bitchsky"
44+let APP_GROUP = "group.app.witchsky"
55typealias ContentHandler = (UNNotificationContent) -> Void
6677// This extension allows us to do some processing of the received notification
···170170 <View style={[a.gap_xl]}>
171171 <Text style={[a.gap_md, a.leading_normal]}>
172172 <Trans>
173173- Bitchsky is part of the{' '}
173173+ Witchsky is part of the{' '}
174174 {
175175 <InlineLinkText
176176 label={_(msg`ATmosphere`)}
···216216 <Trans>
217217 Don't have an account provider or an existing Bluesky account? To
218218 create a new account on a Bluesky-hosted PDS, sign up through{' '}
219219- {/* TODO: Xan: change to say sign up for a Bitchsky account */}
219219+ {/* TODO: Xan: change to say sign up for a Witchsky account */}
220220 {
221221 <InlineLinkText label={_(msg`bsky.app`)} to="https://bsky.app">
222222 <Trans>bsky.app</Trans>
223223 </InlineLinkText>
224224 }{' '}
225225- first, then return to Bitchsky and log in with the account you
225225+ first, then return to Witchsky and log in with the account you
226226 created.
227227 </Trans>
228228 </Text>
···106106 ">
107107 <h1 lang="en">JavaScript Required</h1>
108108 <p lang="en">This is a heavily interactive web application, and JavaScript is required. Simple HTML interfaces are possible, but that is not what this is.
109109- <p lang="en">Learn more about Bluesky at <a href="https://bsky.social">bsky.social</a> and <a href="https://atproto.com">atproto.com</a>, or this fork at <a href="https://github.com/jollywhoppers/bitchsky-app">github.com/jollywhoppers/bitchsky-app</a>.
109109+ <p lang="en">Learn more about Bluesky at <a href="https://bsky.social">bsky.social</a> and <a href="https://atproto.com">atproto.com</a>, or this fork at <a href="https://tangled.org/jollywhoppers.com/witchsky.app/">https://tangled.org/jollywhoppers.com/witchsky.app/</a>.
110110 </noscript>
111111112112 <!-- The root element for your Expo app. -->