2024-03-02 04:15:11 +00:00
|
|
|
# Ente's web apps
|
2020-09-09 21:09:51 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
Source code for Ente's various web apps and supporting websites.
|
2021-08-22 19:21:32 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
Live versions are at:
|
2022-12-15 13:54:22 +00:00
|
|
|
|
2024-04-03 08:03:42 +00:00
|
|
|
- Ente Photos: [web.ente.io](https://web.ente.io)
|
|
|
|
- Ente Auth: [auth.ente.io](https://auth.ente.io)
|
2021-08-22 19:21:32 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
To know more about Ente, see [our main README](../README.md) or visit
|
|
|
|
[ente.io](https://ente.io).
|
2022-09-13 13:36:35 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
## Building from source
|
2021-08-22 19:21:32 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
Fetch submodules
|
2020-09-09 21:09:51 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
```sh
|
|
|
|
git submodule update --init --recursive
|
|
|
|
```
|
2021-07-28 09:07:52 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
Install dependencies
|
2022-09-13 13:36:35 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
```sh
|
|
|
|
yarn install
|
|
|
|
```
|
2020-09-09 21:09:51 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
Start a local development server
|
2020-09-09 21:09:51 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
```sh
|
|
|
|
yarn dev
|
|
|
|
```
|
2022-09-13 13:36:35 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
That's it. The web app will automatically hot reload when you make changes.
|
2021-08-22 19:21:32 +00:00
|
|
|
|
2024-03-31 11:34:38 +00:00
|
|
|
If you're new to web development and unsure about how to get started, or are
|
2024-03-08 07:41:04 +00:00
|
|
|
facing some problems when running the above steps, see [docs/new](docs/new.md).
|
2021-08-22 19:21:32 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
## Other apps
|
2022-02-20 10:14:40 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
By default, `yarn dev` builds the Photos app. You can build the auth app by
|
|
|
|
doing `yarn dev:auth`.
|
2024-02-22 06:52:07 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
To see the full list of apps you can run (and other scripts that you can use),
|
|
|
|
use `yarn run`.
|
2022-09-13 13:36:35 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
For more details about development workflows, see [docs/dev](docs/dev.md).
|
2022-02-20 10:14:40 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
## Directory structure
|
2022-02-20 10:14:40 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
As a brief overview, this directory contains the following apps:
|
2022-09-13 13:36:35 +00:00
|
|
|
|
2024-04-03 08:03:42 +00:00
|
|
|
- `apps/photos`: A fully functional web client for Ente Photos.
|
|
|
|
- `apps/auth`: A view only client for Ente Auth. Currently you can only view
|
|
|
|
your 2FA codes using this web app. For adding and editing your 2FA codes,
|
|
|
|
please use the Ente Auth [mobile/desktop app](../auth/README.md) instead.
|
2022-02-20 10:16:59 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
These two are the public facing apps. There are other part of the code which are
|
|
|
|
accessed as features within the main apps, but in terms of code are
|
|
|
|
independently maintained and deployed:
|
2022-02-20 10:16:59 +00:00
|
|
|
|
2024-04-03 08:03:42 +00:00
|
|
|
- `apps/accounts`: Passkey support (Coming soon)
|
|
|
|
- `apps/cast`: Chromecast support (Coming soon)
|
2022-09-13 13:36:35 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
> [!NOTE]
|
|
|
|
>
|
|
|
|
> This folder is supposed to contain all our web related code. Most of it is
|
|
|
|
> already here, but some code which is being deployed from our other
|
|
|
|
> repositories like the family portal (https://github.com/ente-io/families)
|
|
|
|
> still needs to be brought here. Also, some of the Cloudflare workers we use
|
|
|
|
> for fixing headers etc too. Hang tight, we're on it, will bring in the
|
|
|
|
> remaining bits one by one.
|
2022-02-20 10:14:40 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
You might also find this [overview of dependencies](docs/dependencies.md)
|
|
|
|
useful.
|
2022-02-20 10:14:40 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
## Attributions
|
2023-02-05 13:28:15 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
City coordinates from [Simple Maps](https://simplemaps.com/data/world-cities)
|
2023-02-05 13:28:15 +00:00
|
|
|
|
|
|
|
## 🌍 Translate
|
2024-03-02 04:15:11 +00:00
|
|
|
|
2023-03-21 13:39:10 +00:00
|
|
|
[![Crowdin](https://badges.crowdin.net/ente-photos-web/localized.svg)](https://crowdin.com/project/ente-photos-web)
|
|
|
|
|
2024-04-03 08:03:42 +00:00
|
|
|
If you're interested in helping out with translation, please visit our
|
|
|
|
[Crowdin project](https://crowdin.com/project/ente-photos-web) to get started.
|
|
|
|
Thank you for your support.
|
2023-02-05 13:28:15 +00:00
|
|
|
|
2024-04-03 08:03:42 +00:00
|
|
|
If your language is not listed for translation, please
|
|
|
|
[create a GitHub issue](https://github.com/ente-io/ente/issues/new?title=Request+for+New+Language+Translation&body=Language+name%3A)
|
2024-03-02 08:07:12 +00:00
|
|
|
to have it added.
|
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
## Contribute
|
2024-02-17 04:54:28 +00:00
|
|
|
|
2024-03-02 04:15:11 +00:00
|
|
|
For more ways to contribute, see [../CONTRIBUTING.md](../CONTRIBUTING.md).
|