Skip to content

Commit

Permalink
fix: update favicon and add README (#7)
Browse files Browse the repository at this point in the history
* fix: update favicon

* fix: add readme

* fix: update readme
  • Loading branch information
masnormen authored Dec 20, 2024
1 parent 64b18a9 commit 5b51eac
Show file tree
Hide file tree
Showing 8 changed files with 164 additions and 357 deletions.
89 changes: 42 additions & 47 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,63 +1,58 @@
# Ziyo
<h1 align="center">Ziyo</h1>

<a alt="Nx logo" href="https://nx.dev" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-logo.png" width="45"></a>
<p align="center">
<img src="assets/ziyo-search-ui.png" width="600">
<br/>
<i><a href="https://ziyo.nourman.com" target="_blank">ziyo.nourman.com</a></i>
</p>

**This workspace has been generated by [Nx, a Smart, fast and extensible build system.](https://nx.dev)**
**Ziyo** (Japanese: ジヨ */jiyo/*) is a stupidly simple online Kanji dictionary and search engine.

With Ziyo, you can search across thousands of kanji and view its readings, meanings, variations, and example sentences. It is targeted for Japanese learner who wants to do a quick but deep search about a kanji.

## Start the app
**Search a kanji by:**

To start the development server run `nx serve ziyo`. Open your browser and navigate to http://localhost:4200/. Happy coding!
- Onyomi reading (Kana/Latin)
- Kunyomi reading (Kana/Latin)
- Chinese Mandarin reading (Pinyin readings)
- Korean reading (Hangul/Latin - Hanja readings)
- Meanings (in English)

## Features
- Search and browse Kanji characters.
- Detailed information for each Kanji, including meanings, readings, and examples.
- User-friendly interface. With romaji support for those who are not familiar with kana.
- Opengraph image for quick sharing on social media.

## Generate code
<p align="center">
<img src="assets/ziyo-kanji-og.png" width="400"><br/>
<i>Open Graph image for Kanji page</i>
</p>

If you happen to use Nx plugins, you can leverage code generators that might come with it.
## Technologies used

Run `nx list` to get a list of available plugins and whether they have generators. Then run `nx list <plugin-name>` to see what generators are available.
- Next.js for frontend
- Hono.js for backend
- Tailwind + Shadcn UI
- Typesense (search engine)
- Nx Monorepo
- pnpm

Learn more about [Nx generators on the docs](https://nx.dev/plugin-features/use-code-generators).
## Development

## Running tasks
```sh
# Clone the repository
git clone https://github.com/masnormen/ziyo.git
cd ziyo

To execute tasks with Nx use the following syntax:
# Install dependencies
pnpm install

# Start the development server for both frontend and backend
pnpm dev
```
nx <target> <project> <...options>
```

You can also run multiple targets:

```
nx run-many -t <target1> <target2>
```

..or add `-p` to filter specific projects

```
nx run-many -t <target1> <target2> -p <proj1> <proj2>
```

Targets can be defined in the `package.json` or `projects.json`. Learn more [in the docs](https://nx.dev/core-features/run-tasks).

## Want better Editor Integration?

Have a look at the [Nx Console extensions](https://nx.dev/nx-console). It provides autocomplete support, a UI for exploring and running tasks & generators, and more! Available for VSCode, IntelliJ and comes with a LSP for Vim users.

## Ready to deploy?

Just run `nx build demoapp` to build the application. The build artifacts will be stored in the `dist/` directory, ready to be deployed.

## Set up CI!

Nx comes with local caching already built-in (check your `nx.json`). On CI you might want to go a step further.

- [Set up remote caching](https://nx.dev/core-features/share-your-cache)
- [Set up task distribution across multiple machines](https://nx.dev/nx-cloud/features/distribute-task-execution)
- [Learn more how to setup CI](https://nx.dev/recipes/ci)

## Connect with us!
Open your browser and go to `http://localhost:3000` to view the frontend application.

- [Join the community](https://nx.dev/community)
- [Subscribe to the Nx Youtube Channel](https://www.youtube.com/@nxdevtools)
- [Follow us on Twitter](https://twitter.com/nxdevtools)
## License
This project is licensed under the MIT License.
Binary file removed apps/ziyo-fe/public/favicon.ico
Binary file not shown.
Binary file added apps/ziyo-fe/public/ziyo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 5b51eac

Please sign in to comment.