Engineering resources

YOSHINANI

技術・開発リソース

つくる知恵を、ひらいていく。

日々の開発で育ててきたルールや、プロジェクトの土台。
YOSHINANIは、技術ノウハウをコードと一緒に公開しています。

GitHubで公開リポジトリを見る

ENGINEERING / 開発の共通基盤

  1. テンプレートから開始

    Next.js・Expoの共通構成を開発の出発点に。

  2. ルールを共有

    スタイルガイドで記述やチェックの基準を揃える。

  3. 知見を公開

    スキル・共通ユーティリティ・実装例を共有する。

各リポジトリの内容・利用条件はリンク先で確認できます。

01 / Code quality

コード品質

チームで、同じ基準を持つ。

  • style-guide

    YOSHINANI スタイルガイド

    コードの書き方や整え方をチームで共有するための設定集。Biome・ESLint・TypeScript・commitlint・CSpellの設定をまとめています。

    共有設定 / @yoshinani/style-guide

    GitHubで見る
  • utils

    共通ユーティリティ

    日付の表示、文字列の変換、ファイルの拡張子取得など。開発で繰り返し使う小さな処理を、共通の関数としてまとめています。

    TypeScript / @yoshinani/utils

    GitHubで見る

02 / Project templates

開発テンプレート

つくり始めるための土台。

  • yoshinani-template-base

    Webアプリ開発のテンプレート

    Next.jsのアプリとshadcn/uiベースの共通UIを、Turborepo・pnpmで管理する構成。スタイルガイド、テスト、CIの設定を含む開発の出発点です。

    Next.js / Turborepo / pnpm

    GitHubで見る
  • monorepo-template-expo-firebase

    Expo × Firebaseのテンプレート

    ExpoとFirebaseを組み合わせたモノレポ構成を公開しています。アプリ開発のプロジェクト構成を考える際の参考に。

    Expo / Firebase / モノレポ

    GitHubで見る

03 / Working with AI

AI開発支援

AIにも、仕事の進め方を共有する。

  • skills

    AIアシスタント向けスキル集

    PR本文の作成・更新や、freee MCPを使う業務の手順をスキルとして公開。AIアシスタントに作業の進め方を伝えるための知見をまとめています。

    AIアシスタント / PR作成 / 業務手順

    GitHubで見る
  • yoshinani-cursor-rules

    Cursor向け開発ルールの例

    Next.jsのパラメータ処理、型定義、Server・Client Componentの責務分離を扱うルール例。AIと開発方針を共有するための参考資料です。

    Cursor / Next.js / 開発ルール

    GitHubで見る

04 / Implementation examples

実装サンプル

仕組みを、コードから知る。

  • stripe-terminal-demo

    Stripe Terminalの決済デモ

    決済リーダーの検出・接続から決済までを扱うNext.jsのサンプル。Stripe Terminalを使った対面決済の実装を確認できます。

    Stripe Terminal / Next.js / 決済

    GitHubで見る
  • n8n

    n8nのセットアップと活用例

    n8nを起動する手順と、Slackの質問を担当部署へ振り分けるAIエージェントのプロンプト例を公開しています。

    n8n / ワークフロー / AIエージェント

    GitHubで見る

公開リソースを、自分たちの開発に取り入れるには

新しい開発を始める場合は、まずWebアプリかモバイルアプリかを整理し、用途に合うテンプレートのREADMEを読みます。使用する言語や実行環境、必要な外部サービスが、自分たちのプロジェクトに合うかを確認してから試してください。既存のプロジェクトなら、構成全体を移す前に、必要な設定や関数を一つずつ検討できます。

複数人で開発するときは、スタイルガイドで記述やチェックの基準を共有し、その基準をAIアシスタントにも伝えます。スキルやルールの例は作業手順を考える材料です。自分たちの権限やレビュー手順に合わせて読み替え、生成された変更も人が確認します。実装サンプルは仕組みの理解に使い、本番に採用する前に認証、エラー時の動作、データの扱いを検証してください。

導入するリポジトリを決めたら、READMEの手順とLICENSEの利用条件を確認し、使用した版を記録します。別の環境や版でも同じ動作になるとは限りません。小さな検証用プロジェクトで動作を確かめ、チームのテストとレビューを通してから本番へ取り入れると、変更の理由や戻し方も共有できます。

Read, explore, build

コードと、その背景も。

導入手順や利用条件は、各リポジトリのREADME・LICENSEをご確認ください。
技術記事やブランド素材も、それぞれの場所で公開しています。