bisonapp

Полный стек Jamstack In-Box

Bison-это стартовый репозиторий, созданный из реальных приложений в Echobind. Он представляет собой «Greenfield Web Stack», который мы используем при создании веб -приложений для клиентов.

Мы всегда улучшаем это, и мы приветствуем предложения от сообщества!

Технология

• Next.js
• Машинопись
• API TRPC для обеспечения безопасности сквозного типа
• Призма с попресс
• Попутный ветер
• Реагировать форму крючка
• Драматург для тестов E2E
• Библиотека испытаний и шутки для испытаний на подразделение и запросы API

Функции

• Настраиваемые шаблоны Hygen для генерации новых файлов
• Полностью подключенные страницы для входа/регистрации с помощью клиентской и серверной проверки.
• Eslint, предварительно сконфигурированный с лучшими практиками Echobind
• Путь импорта псевдоним в папку проекта корневого проекта ( @/ ), чтобы избежать необходимости длинных относительных путей импорта.
• Настройка для компонентов с UI.Shadcn.com

Конвенции

• Не копируйте/вставьте файлы, используйте генераторы и шаблоны Hygen. Нужно обновить генератор по мере развития вашего проекта? Все они в папке _templates .
• Не пишите типы вручную для процедур TRPC. Выводите типы из определения маршрутизатора.
• Все страницы на переднем крае по умолчанию статичны. Если вам нужно что -то отображаемое сервер, просто добавьте getServerSideProps как вы бы в любом следующем приложении.
• Вместо создания компонентных классов CSS (например, .btn или .input ) или установки библиотеки компонентов, компоненты пользовательского интерфейса следует копировать/вставать в папку /components/ui и регулировать по мере необходимости. UI.Shadcn.com является рекомендуемым источником этих компонентов.

Компромисс

• Чтобы уменьшить сложность, Bison избегает рабочей пространства пряжи и отдельных папок верхнего уровня. Подумайте о своем приложении, как о традиционном монолите, но с отдельным фронтом и API. Это означает, что папки могут быть немного более смешанными, чем вы привыкли.

Альтернативы

Несколько других проектов, которые быстро созревают в полном помещении Jamstack.

Redwoodjs Redwood - очень многообещающая рамка, которую мы смотрим. Мы взяли концепцию «ячеек» непосредственно из Редвуда (хотя по общему признанию наша версия занимает немного больше кода!)

Blitz.js Blitz также очень многообещающий. Блиц построен на следующем.js (который мы любим!) И использует совершенно другой подход, пытаясь удалить слой API, используя конвенции, предоставленные Next.js.

Мы можем одолжить концепции из Redwood и Blitz с течением времени или даже переключиться на один, поскольку они продолжают взросление.

Думайте о Bison как о металле и предварительно настроен для максимальной DX и эффективности. Хорошая новость заключается в том, что если вы не согласны с каким -либо выбором, который мы сделали, от вас ничего не скрыто. Вы можете адаптировать «структуру», чтобы соответствовать вашим потребностям.

---

Начиная

Создайте новое репо из шаблона бизонов.

Использование пряжи:

yarn create bison-app MyApp

Используя NPX:

npx create-bison-app MyApp

Настройка базы данных

Пожалуйста, обратитесь к: Настройка Postgres.

Запустите приложение локально

Из корня запустите yarn dev . Это работает next dev для запуска функций Frontend и без сервера локально.

Следующие шаги

После того, как приложение работает локально, вы захотите настроить развертывание.

Док

• Рекомендуемый Dev Workflow
• Развертывание

Есть идея улучшить бизон? Дайте нам знать!

---

О эхобинде

Echobind-это цифровое агентство с полным спектром услуг, которое создает веб-и мобильные приложения для клиентов в различных отраслях.

Мы эксперты в React, React Native, Node, GraphQL и Rails.

Если вы создаете новое приложение, ваша команда решает сложную проблему, или вам просто нужна помощь в прохождении финишной черты, мы хотели бы работать с вами. Скажи привет и скажи нам, над чем ты работаешь!