# Tungsten

[Japanese version](https://gitlab.com/tatsuokitakayuki/tungsten/-/blob/master/README-JP.md)

[![pas](https://img.shields.io/static/v1?&message=ProgressiveApp.Store&color=74b9ff&style=flat&label=Follow%20Tungsten%20at)](https://progressiveapp.store/pwa/Tungsten)

## What is this

Tungsten is an application that edits text and code, which is implemented only by Web technologies (HTML, CSS, and JavaScript).
A Web App that can be installed offline on a device like Tungsten is called a Progressive Web Application (PWA).
We are developing Tungsten mainly for Chromebook (or Chromium OS and its based OS) users.

## Project goals

- Make Tungsten a practical text code editor.
    - Add functionality.
    - Fix the defect.
    - Maintain.

## Features of Tungsten

- It is a progressive web app.
- Works offline.
    - A network connection is required only during background automatic update processing.
- All processing is done in the browser of the device.
- It supports "File system access API" for reading and writing files in local storage.
- Do not use cookies.
- Open source software.

## Disadvantages of Tungsten

- The save function is supported only by some browsers.
    - For browsers that do not support the save function, use the download function instead.

## System requirements

- OS
    - Chrome OS (Main target, Tested)
    - Linux (Reported to work)
    - Windows (Tested)
    - Mac
    - Android (Tested, but unstable)
    - iOS
    - iPadOS
- Browser
    - Chrome (Version 63 or higher, Main target, Tested)
    - Firefox (Version 67 or higher)
    - Edge (Version 79 or higher)
    - Safari (Version 11.1 or higher)

## List of libraries and frameworks used

* [Ace](https://ace.c9.io/)
* [Material Design Component for Web](https://material.io/develop/web/)
* [Material Design Icons](https://google.github.io/material-design-icons/)
* [localForage](https://localforage.github.io/localForage/)
* [emmet-core](https://github.com/cloud9ide/emmet-core)

## License

This program is open source software; it is distributed under the [MIT License](https://gitlab.com/tatsuokitakayuki/tungsten/-/blob/master/LICENSE).

## How to use

### How to try immediately

- [stable](https://tungsten.kirari.app/)
- [dev](https://tungsten.kirari.dev/)
    - This app uses [Firebase](https://firebase.google.com/) hosting services.

### How to try locally

1. Clone this repository.
    - `git clone https://gitlab.com/tatsuokitakayuki/tungsten.git`
2. Change to the public directory.
    - `cd tungsten/public/`
3. Start the HTTP server.
    - `python3 -m http.server --bind 127.0.0.1 8080`
4. Open localhost:8080 in your web browser.

Please try.

## Contact information

* 龍興 尚幸 (Tatsuoki, Takayuki): Project leader
    - Twitter: @ttatsuoki
    - e-mail: takayuki.tatsuoki@gmail.com

Feel free to.